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Application Settings قıبطتلا إعدادات‎ 


لقد بحث المبرمجين عن طريقة مريحة لصيانة القيم القابلة للتركيب في تطبيقاتهم.في الأيام الأولى للتطوير بميكروسوفت دوس؟15-20 .كان التركيب متاح للجميعكل 
برنامج يوفر نظام إعداداته الخاصة.العديد من التطبيقات لا تحتاج تركيب متخصص,.»ولكن تلك التي تخزن إعدادات التركيب مع بيانات التطبيق المدارة»جميعها في ملفات 
.d‏ خاصة. 

مع حلول تطوير ويندوز السائد.قدمت ميكروسوفت ملف معتمد على إدارة الإعدادات من خلال "واجهة البرمجة التطبيقية application programming interface‏ 
")A۸۴1(‏ الخاصة به."المعنون الخاص ۸۲1" یږتدeي SetPrivateProfileString«GetPrivateProfileString «GetPrivateProfile1¬t)‏ .إلخ) والتي تزود 
طريقة قياسية لتخزين قيم تركيب مختصرة في تنسيق ملف نصي مفتوح و سهل الفهم.استخدمت ميكر وسوفت الملفات" 1١1‏ " (مسماة من أجل امتداد ملفها 1]. ) هذه من 
أجل التر كيب الخاص بها.العديد من هذه الملفات تبقى قابعة في مجلد ويندوز ءسهه”۷لنظامك.إليك المحتوى الموجود في ملف نظامي اأ W٣.‏ . 

for 16-bit app support ‘ 

[fonts] 

[extensions] 

[mci extensions] 

[files] 

[Mail] 

MAPI|I=1 

CMCDLLNAME32=mapi32.dll 

CMC=1 

MAPIX=1 

MAPIXVER=1.0.0.1 

OLEMessaging=1 

[MCI Extensions.BAK] 

aif=MPEGVideo 

التنسيق لملف 11 سهل الفهم.كل ملف متضمن مقاطع مسماة معرفة ضمن أقواس مربعةءكما في [الخطوط ء١‏ ه؟ ].كل مقطع محفوظ كمجموعة أزواج : قيمة - مفتاح 
في نموذج "المفتاح ره) = القيمةم اه۷ ."التنسيق بسيط بشكل كافي بحيث يستطبع أياً كان استخدام المفكرة ١2م‏ هل لعمل تفيرات.وليس حتى من الصعب بالنسية 
لبرنامج من أن يكنب إجراءاته الروتينية الإدارية لملف ءاا؟-1١1‏ الخاص بهءولكن تضمينهم في واجهة برمجة تطبيقية لويندوز ۸۴1 sس0ل”‏ ۷1 يجعل منها أكثر جاذبية 
.ومن تم جاءت الفوضى.مع اختيار العديد من البرامج تخزين ملفات التركيب الخاصة بها فيما يعرف بالموقع المركزي.فإن مجلد س٥ل‏ ”۷أصيج بسرعة الملف المكافئ 
لمحطة غراند المركزية يوم الجمعة عند الساعة الخامسة مساءآً في نيويورك.كانت السرعة هي المشكلة»وأيضاً بما أن الثبات في تفسير وإعادة كتابة ملفات11 تستهلك 
مصادر وحدة المعالجة المركزية لC۴‏ الثمينة. 

تقدمت ميكر وسوفت بحل:التسجيل ۲٤و٥۲‏ .فهو عبارة عن قاعدة بيانات هرمية من أز واج قیمة مفتاح u٥‏ ا۷ر تنظف نظام الملفات ۵۳ء/5٥|ا۴وتجلب‏ تحسينات 
السرعة لادارة الإعداد.وهو يضيف أيضاً إدارة إعدادات الأمان مسبقة التعريف جديدة لامكانية الوصول للمسجل/۲ءأوه؟ .ويوفر دعم ليعض البيانات المحددة النوع. 
ولكن ميزة واجهة البرمجة التطبيقية (أو واجهة برمجة التطبيق۸۴1 )الجديدة لم تكن سهلة الاستخدام والفهم(على الرغم من أن الفيجوال بيسك عملت على تضمين أوامر 
بسيطة» مثل و ۲5ع والتي توفر إمكانية وصول محدودة لمفاتيجح التسجيل كره) ۷ا†ءاوre‏ والقيمvalues‏ .( 

تقنية إلقاء التسجيل (أو طرح التسجيل) عند وجود مشكلة في قيم الإعدادولكن هذه التقنية لم تكن نصراً كاملا .فمع العديد من البانعين الذين يحشون الكثير من البيانات في 
الريجستري.يصبح الاتتفاخ(التضخم) مشكلة مرة أخرى.ومع إدارة النظام فإن الجمبع بإمكانه الوصول إلى الريجستري»وبالتالي كلما تضخم الريجستري»كلما أصبح الأداء 
آأسوء. 
تضمن الإصدار الأول للدوت نت ملفات إعداد خاصة بالتطبيق.تعود نوعاً ما إلى أيام ملف #|ا؟-N1[.في‏ بعض الطرقءملفات وا؟١0ء.ممة‏ و واگہهء.طعمw‏ كانت أفضل 
من ملفات 1 [بما آنها تحتوي محتوی تر کیب 1 ×.ولکن ملفات 11 لدیها تر کیب»وتستطبع تحدیتها بالمفکرة. ملفات ۸۴9٥ء‏ للدوت نت کانت ذات صيت سيء فما 
يخص صعوبة التحديث»إما ضمن تطبيق الدوت نت أو خارجياً في المفكرة(تبعاً لإصدارات الذاكرة المخفية السحريةو” ا۸ء ل٣‏ امس ) وأيضاً ملفات وا۴ ۸٥ء.‏ ليس لديها 
أمن رااcuهءولا‏ حتى تحديد أنواع بيانات قوية ومر ةل 9١٠١ء‏ متاحة في الريجستري. 
لقد دفعت إعدادات التركيب على الأقل مستوى ما من القلق لدى المبرمجين منذ الظهور الأول للويندوز.ولكن نظام إعدادات جديد مطور تم إضافته للمرة الأولى للفيجوال 
بيسك 2005.سعی لتغبیر کل ما کان. 


نظام الإعدادات في الفيجوال بيسك2008 متعدد الملفات» معتمد على ا۷×.محدد النوع بقوةك١ع‏ مرا راو١ه۲ء‏ .وتضاهي التر اكيب السهلة الإدارة. 


.يتم تخزين البيانات في تنسيق ا۷ ×من أجل المعالجة الفعالة بواسطة مكتبات الدوت نت.على الرغم من أنها ليست صورة حرة لنص.فإن ا۷ ×غالياً ليست صعبة عند 
الحاجة إلى التحديث اليدوي الذي يتم عمله من قبل الإنسان. 

.البيانات المخزنة في كل ملف إعدادات خاص محددة النوع بقوةءتقلل الأخطاء الناتجة عن معالجة البيانات الغير صحيحة. 

.يتم إدارة الإعدادات على كل تطبيق.كل مستخدم وحتى على كل قاعدة إصدار مجمع لتعزيز الأمن وتقليل التعارضات.تستطبع أيضاً تخزين عدة مجموعات من الإعدادات 
لكل تطبيق حسب الحاجةءمثل مجموعة إعدادات كل مستند يتم فتحه من قبل تطبيقك.(ولن أناقشه في هذا الفصلءولكن تستطبع البحث عن “SettingsKey‏ 

ty"‏ eمداممن‏ خلال المساعدة على الشبكة لمزيد من المعلومات حول هذه الميزة). 

.تتضمن الفيجوال أستوديو أداة إدارة قريبة(محببة)من المستخدم اھت nanagemen†‏ yاriend؟-userتستخدم‏ لترکیب إعدادات ضمن التطبیق. 

.لدى الفيجوال بيسك واجهة بسيطة خاصة بها لجعل المستخدم يستخدم ويحدث الاعدادات وقت التنفيذ بشكل أسهل. 
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ولكن ليس جميعها للمتعة واللعب.كمطور. يقع عليك حمل تقيل.مثل إظهار أسماء ذات معنى معبرة لكل إعداد(متل "موقع النموذج الرئيسيMainFormLocation‏ 
"."اتصال قاعدة البيانات ^ DatabaseCon ne1٥‏ ".إلخ من الأسماء المعبرة) 


.وقت التصميم كل الإعدادات التي تعمل على إنشاءها يتم تخزينها في ملفءو١:]٤٤٥ء.ءو”:†٤عS‏ المخزن في الدليل الفرعي Ny ۶۲٠ز ٥ ٤‏ لمجلد كودك المصدري.إليك 
ملف 5وہ 1٤†s.seوettinككما‏ هو موجود حتى الآن في مشروع المكتبة: 
Coxml version l1 Ol eNESdANS>- UEE O2‏ 
CSeEEIRNGSEIlE xmlns "hEEP://SEeNemaS . M1 CEOSOEE . COM/V1 SUa1SEUQA10/ 2002/01 /SEEEINOSL‏ 
CurrentProfile=" (Default)" UseMySettingsClassName="true">‏ 
<Profiles>‏ 
<PrOf1le Name" (Default) />‏ 
</Profiles>‏ 
OEE EOS‏ 
</SettingsFile>‏ 
.وقت التنفيذء تظهر جمبع الاعدادات الخاصة بالمستخدم في ملف وآ۴١٥٤.۲٥ء/ءيتم‏ تخزينها نموذجياً في: 
C :\Documents and Settings\ <user> \Local Settings\Application Data\<company>\< appdata >\ < version >‏ 
حیث ٤۴۲<‏ ءا > اسم مستخدم ويندوز ع" Windows use ١2‏ .< anyرمmهc>‏ هو اسم الشركة المسجل في المجمعراا"عءءھ . < taہdممہ>‏ هو تجمیع من القیم 
يساعد على تميز إعدادات معتمدة على لاستخدام و < 10۸ء٣٠۷‏ > هو الأرقام الأربع للاصدار الخاص بالمجمع(رقم الإصدار).من الواضح وكأنه مكان صعب لتخزين 
الإعدادات.ولكن يحفظ الأشياء جميلة ومرتبة.(موقع ملف وا؟١هء.۲ءءں‏ نوعاً ما مختلف إذا ما نشرت تطبيق باستخدام ٠٤0۸ء‏ ا٤.هذه‏ الطريقة سيتم إنشاء الله شرحها 
في الفصل 25). 
ربما تتسال فيما إذا كان هذا يشارك في تضخم القرص. الجواب : نعم!فكل مرة توسع(تكير )رقم إصدار تطبيقك.تعمل الدوت نت على إنشاء ملف إعدادات جديد ليتم شحنه 
مع هذا الاصدار الجديد.توجد طريقة لتخفيف هذا نوعاً ماءولكن مع محركات أقراص صلية(هاردات)120غیغابایت. فلا أحد سیتذمر (يشتكيو ٣٣1هام‏ ٣٥ء‏ )فيما يخص 
مساحة القرص المستخدمة بعد الآن. 
.بعض الاعدادات تكون متمركزة حول التطبيق ك عءدءه؟-١٥اةءاام‏ مه .ويتم تقديمها إلى جميع مستخدمي التطبيق على محطة(شبكة عمل)خاصة.ويتم تخزينها في 
الملفواهء.ممه الذي يظهر في نفس مجلد مجمعك القابل للتنفيذ عاط ة†uءم×ءع‏ ء'راا"عءءه .وتظهر الإعدادات في تفرع 1× 
مسمى < ap ماicatio Se ٤1٣95‏ > ضمن هذا الملف.الإعدادات المتمركزة حول التطبيق ١عءuعه؟-١٠ااةءاام‏ م۸ لايمكن تعديلها بواسطة التطبيقعليك تحديث 
الملف و0۸ء.مم٠‏ يدوباً لإجبار التفيرات. 
نظام الإعدادات ١٣ءاكرء‏ كو آ†#ء مكان عظيم لتخزين حالةءأشياء تريد من البرنامج أن يتذكرها من المرة الأخيرة التي تم تشغيلها فيه»ولكن يجب أن لايكون هذا صعب 
التشفير (صعب التكويدك عك ٥ء‏ ١۲ه"‏ )في الكود المصدري. 


توفر نافذة خصائص المشروع في الفيجوال أستوديو2008 سيطرة مركزية على إعدادات تطبيق ما.لوحة الاإعدادات لهذه النافذة مبينة في الشكل التاليء وهي توفر 
إمكانية الوصول إلى الإعدادات المخصصة للتطبيق. 

لإضافة إعدادات»اكتب في اسمهاه"ه. .اختر نموذج نوع ءمرآبياناتها من القائمة المنسدلةء اختر المجال مم50 (مستخدم ۲٥ءلاآو‏ تطبيق١٥اةءام‏ م۸ )ءوأدخل 
قيمها عند ا۷2باستخدام القيم المتاحة من قبل المحرر من أجل النوع المختار.تتضمن قائمة النوع العديد من الاختيارات الافتر اضية»من ضمنها أنواع بيانات الفيجوال بيسك 
القاعديةكممرt the basic Visuaا Basic data‏ .الخطوطntsدf‏ .الألوانءهامع .والقياسات ذات الصلة بالرسمءعizء drawing -reاa† ed‏ . ومضمن أيضاً 
نوع" (نص الاتصال )Connec†i 0۸ s۲٣‏ "والذي عند اختیاره»یمگن باني نص خاصيات lتڏصJl Connection Properties string builder‏ في عمود 
Value‏ القيمة. 

إنه لمن الهام أن تختار النوع الصحبح لكل إعداد مخزنو١:ا†هء‏ ١٠۲٠ء‏ »وإلاء فإن كمبيوترك سينفجر.عملياًءإني أعتقد أنهم نسقوا هذا في وقت متأخر.وهو كذلك. لان 
جميع الاإعدادات محددة النوع بقوةكعمرا راو ه۲اء .إذا وضعت النوع إلى انتغر٣#وع"1‏ .لن تكون قادر على إقحام الكلمة ٥١٣٠۸هناك‏ كإشارة خاصة كما يمكنك 
عمله مع الملف[1N‏ .تستطبع اختيار أي نوع دوت نت متاح(محقق) مما ..٤۲‏ هناج من أجل نوع البياناتهمر† هة .على الرغم من أن الأنواع المعقدة بدون 

محر راتھا الخاصة بھا custom ed٣‏ مسw٥.‏ سیتطلب منك وضع قیمھا من خلال الکود. 
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YYindowsA pplication] - Microsoft Yisual Studio 
Fils Edl Yiemw Project Build Debug Data Tools Test Windom Help 


ا لا س ا ج هة لان 


Window sApplicationî 1# Farml.vb [Design] Î Start Page |‏ ا 
Application Symehronize | EN) Loadieb Settings | Yiew Code‏ 


Lompila E 
pplication settings allow pou to store and retriewe properly settings and other 

information for your application dynamically. For example, the application can save 

Debug a user's color preferences, hen retrieve them the next Hime il runs. Learn more 


about application settings... 


References 


Name | Type Scope 


n 
ت‎ 
ت‎ 
1 
IT 
2 
َه‎ 
2 
8 
e, 
mM 
i 
el 
= 
ِ 
5 
U 
ا‎ 


Resources 
Setting [Connection .. ww | Application 


Services 
| 


Settings” 


Error List Immediate Window‏ ا 
2 ڪھ Ready‏ 
ما الذي يحدث عند إضافة إعداد جديد لمشروع الفيجوال؟لنستكشف دلك.سأعمل على إضافة إعداديين إلى مشروع نماذج ويندوز:انتفر ٣#وعأ١امسمى .WarningLimit‏ 
و ing.FontْSystem.Drawمسمی NoticeFont‏ (شاهد الشکل التالي). 


mm Name # | Type | Scope | Yalue 


Naloeront  SuienDiam. Js aT TEZE VEBE . 


كما تعلم مسبقاًءالفيجوال أستوديو هي مجرد إزار قريب من المستخدم حول كود الدوت نت.ولوحة الإعدادات ام٣هم‏ كو” )ه8 لا تختلف عن ذلك.لذلك تحدث التفيرات 
الحقيقة في مكان ما ضمن الكود أو بدقة أكثر.في كل من الكود علهعوملف ءو”/اعء.ئو”/٤٠6‏ ذو الصلة.إذا ما "أظهرت جمبع الملفات5 ۴|۴ ال۸ SW‏ "في 
مستکشف الحلول.ومددت 6 ز۴۲ Ny‏ متبوعاً ب و۸ /٤‌ء.یو6614.ستجد‏ آن ملف ا۷ ×هذا لدیه ملف کود فیجوال بيسك مصدري خاص به 

. Settings. Designer. vb 

إذا فتحت الملفط "٥۲١‏ s/9ع0‏ .ئو /1)عS‏ »ستجد الكود الجزئي التالي: 


<Global.System. Runtime.CompilerServices.CompilerGeneratedAttribute (), _ 
Global.System.CodeDom. Compiler. GeneratedCodeAttribute ("Microsoft.VisualStudio.Editors.SettingsDesigner.Settings 


Single leGenerator ll, 000 
Global.System.ComponentModel.EditorBrowsableAttribute (Global. System. ComponentModel . 


J 


EditorBrowsableState. Advanced 
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عملت على إخراج الكثير من الكود الزائد.إن المذهل كثرة الكود الذي تحمله ميكروسوفت في المواصفات المكتوية مقدماًوليس من الممكن حقاً معرفة ما يجري 
بالداخل.أستطبع أن أخمن ما تعمله المواصفة ضصزAttribu (fault Setting Value‏ بالنسية لكل إعداد(تسند القيمة الافتر اضية الأولية للاعداد).ولكن بعض المواصفات 
الأخرى غامضة. 
ولكن باقي الكود واضح تماماً.تولد الفيجوال أستوديو خاصيتين ضمن الفنةءوہ 1ا 1⁄.۷¥S6‏ »خاصيات مسماة-بشکلJ‏ ممjı‏ وکûlفي- NoticeFontgWarningLimit‏ .إلd‏ 
مدخلة الخاصية .NoticeFont‏ 
Public Property NoticeFont () As Global.System. Drawing. Font‏ 
e‏ 
Return CType (Me ("NoticeFont"), Global.System. Drawing. Font)‏ 
End Get‏ 
SE |‏ 
Me ("NoticeEFont") = value‏ 
End Set‏ 
EMG EEODE EY‏ 
لن تجد أية أعضاء فثات خاصة تخزن قيم ¬ 1-اوہ ا2و NoticeFont|المخفية.بدل‏ ذلك.في مكان ما أخر في هذه الفئة الخاصة وهو الخاصية الافتراضية (مسماة 
mهtا)والتي‏ تمنجح كاهو وتضع كاأعءكل قيمة خاصية محددةهuاVa defined propery‏ «يمكن الوصول إلا .Me("something") Jڵlخ jo‏ 
الاإعدادات المتاحة من خلال هذه الخاصية الافتراضية يتم تحميلها مياشرة من × مخزن في ملفءو”/٤#ء.ئو,‏ 6# .(هذا الملف يتم ترجمته ضمن التطبيق.ليس 
عليك توز يعئو١/١٤#ء.sو, 5٥11‏ مع التطبيق).إليك محتوى من ذلك الملف بالنسبة لقيمتي التركيب الجديدتين الخاصتين بنا: 
E XMmI version 1 0! enNEOdING UE 09>‏ 
<SettingsFile xmlns="http://schemas.microsoft.com/VisualStudio/2004/01/settings"‏ 
CurrentProfile=" (Default) " GeneratedClassNamespace="My" GeneratedClassName="MySettings™‏ 
UseMySettingsClassName="true">‏ 
<Profiles />‏ 
<Settings>‏ 
<Setting Name="WarningLimit" Type="System.Int32" Scope="User">‏ 
WANE Deg 1E =P (DE TALE) 25 MAE‏ 
</Setting>‏ 
<Setting Name="NoticeFont" Type="System. Drawing.Font" Scope="User">‏ 
<Value Profile=" (Default) ">Arial, 14.25pt, style=Bold</Value>‏ 
</Setting>‏ 
</Settings>‏ 
CSeE E ID GSEI NEY‏ 
کل إعداد یحتوي مواصفات کا ں ط٣٤٤‏ أو مدخلاتءعا٣†ہe‏ : اسم Name‏ متميزءنوعe‏ مرا .مجالەمهءS‏ .وقيمة ماج۷ .تطابق الأعمدة الاأربع التي ظهرت في 


محرر إعدادات الفيجوال أستوديو. 
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تنشئ الفيجوال بيسك حالة من فئة و٠ 1y.۷»yS6†٤‏ ولقد ر أيناه منذ قليل في الكود السابق»وتجعلها متاحة ك ءو١ااهS.ر0.فعندما‏ تضيف إعدادات إلى مشروعكءفإنها 
تصبح أعضاء فئة محددة النوع بقوة ل كو٠:)٤ه5.ر0.للوصول‏ إلى واحدءبيساطة أشر إليه مباشرةً في كودك. 

MSGEBOZ (IIe FONE EOE MOEIEGOS 16: C1 CEG WM SECEINIOS NOE CCE ODE LOS EEA TE OD 
تستطبع استخدامها مثل أي حالة خط أخرى.‎ System .DاW‎ ٣9.۴0۸٤ حالة حقيقية ل‎ يهMy.Settin‎ gs. ۴ءع‎ 0٤ مخرجات هذا الكود تظهر في الشكل التالي. إن‎ 
تستطبع تعديل القيمة لأي إعداد ممتد ك"مستخدم#۲ءل ".وتمنحه قيمة جديدة محجوزة لاستخدامك التالي لتطبيقك(على سبيل المتال الاستخدام التالي للمستخدم الحالي‎ 


Mz SEE OSS WE ER MEO E = 0 


WindowsA pplication | 


The fant for notices is: [Fant: Hame=ûrial, Size=1 4.25, Units=3, adiCharSel=1l , adiYerlicalFont=F alse] 


مواق 


جميع التغير ات المعمولة لهذه الإعدادات يتم حفظها بشكل آلي إلى ملفات واه اا ممء-۲موں بشكل افتراضي.إذا كنت لاتريد تحديث ما تم حفظه بشكل آليءضع 
Settings OnE xt‏ ication.SaveMyاMy.App‏ لن یشیر إلى خطأعءاه۴ .ومن تم عندما تكون جاهز لحفظ إعدادات جديدةء استخدم الطريقةe‏ 1.2۷| My.S6‏ . 
تآتي الإعدادات بثلاث مذاقات لذيدة:افتر اضياانا ههل .المستديمة ١#اءاء٣هم‏ .وحالي ١٠١۲ء‏ .الإعدادات الافتراضية كو١ذ)هء‏ اااه؟ه0 هي تلك القيم المعرفة من 
قبل المبرمج من خلال محرر إعدادات الفيجوال أستوديو .تتضمن الإعدادات المستديمة sو”ا†هء‏ ل #اءاء٣ه۴‏ التفيرات المحفوظة إلى إعدادات معينةء والاعدادات 
الافتر اضية لتلك التي لن يتم تعديلها من قبل المستخدم.تتضمن الاإعدادات الحالية sوہ‏ :اء ٤۸٥٣اCu‏ آي تفیرات یتم عملھا للاعدادات خلال الدورة الحالیة ولکن لم یتم 
حفظها بعد. تستطبع التلاعب بهذه الحالات باستخدام أعضاء الكائنءوہ|ا؟مMy.S‏ : 
.الطريقة "حفظ 5۷0 .كما ذكرت سابقاًتحفظ جمبع الإعدادات الحالية إلى حالة مستديمة. 
. الطريقة إعادة التحميل #٠٠٠۵١‏ تجدد أي قيم حالية بالنسخ المستديمة persisted V©rSi0758‏ . 
.الطريقة "إعادة التنضيد ۸٠561‏ تزيل جمبع الإعدادات الحالية والمستديمة وترجع مدخلات تركيب إلى القيم الافتراضية. 
واحدة من السمات الأغرب للاعدادات هي أنها نوعية الإصدار.إذا حررت تطبيقك كإصدار 1.0.0.0ءومن تم فيما بعد حررت الإصدار 1.1.0.0.كل مستخدم سيفقد جمبع 
الاعدادات المستديمة ١ءء‏ همالسابقة.عملياًءلن تفقد.ولكنها ستكون ملتصقة في منطقة۸0ه4!-1.0.0.0.إذا كنت تريد أن تملك دائماً الاعدادات الأحدث عأةل-ه-مں 
كلما تم تغيرها من قبل المستخدم»سيكون عليك التأكد من أن الإعدادات الأقدم"تم ترقيتهال٥١۲۵ومدا‏ " عند تثبيت نسخة جديدة.يتضمن كو١ااه۷.S‏ طريقة ترقية 
لاوم تقوم بهذا العمل لصالحك.ولكن إذا نصب المستخدم النسخة الأحدث ورقى الاإعدادات.وعمل تغييرات على هذه الإعدادات.ومن ثم استدعى ۲208 ومنامرة 
أخرى.فأي تفير ات معمولة منذ الترقية الأخيرة سيتم فقدها. 
لتستوعب(أو تتجنبك 4۲٥١١‏ اهو )هذه المشكلةءسيرقي الكود الإعدادات عندما تظهر نسخة جديدة فقط الطريقة الأسهل لعمل هذا هي بتضمين إعداد يستدعي شيء ما 
مثل edلaاوملءوinااهSووضعها‏ إلى خطأعءام۴ .اختبر هذه العلامة وهاأقبل استدعاء مهوم ل.فإذا بقيت خطأعءاه۴ .فمن الآمن استدعاء مله۲وملا.حالما يرقي 
الكود الاإعدادات«غير gJ!SettingsUpgraded‏ صTruelg‏ . 

Tf (My.Settings.SettingsUpgraded = False) Then 

My.Settings.Upgrade () 
My.Setttings.SettingsUpgraded = True 


El ME 
هذه الحاجة إلى ترقية الإعدادات في أي وقت حتى ولو تم عمل تغيرات على رقم النسخة ١٥٣ا لمجمع ما تبدو قليلاً أعلى القمة.ولكن من الضروري دعم هدف الدوت‎ 
نت: التنصيب جنباً إلى جنب.على المستخدم أن يكون قادر على تنصيب نسختين من تطبيقك على نفس الكمييوتر»واستخدام كل واحد دون التداخل من الآخر. إن تخزين‎ 
يساعد على تحقيق هذا الهدف.‎ version-spم‎ cific إعدادات نوعية الإصدار كو١ )اء‎ 


على الرغم من استخدام وتحديث قيم تركييك الخاصة يمكن أن تكون مثيرةوحتى ما هو أكثر إثارة هو أن الحقول في نماذج ويندوز وأدواتها المناسبة يمكنها أن تتفاعل مع 
الاعدادات المستدیمة بشکل آلي.بر بط ۵/٣9‏ ہ/ظ نموذج ۴٥٣۳‏ وخاصیات İدöl‏ نوعية settings syste mتٽlدlدعlل| مlظزi ılJإ control specific properties‏ .ذإj‏ 
الفيجوال بيسك تحفظ وتجدد بشكل آلي أولويات تحكم المستخدم ٥۸٥65‏ ءام edااcontro-rمsں‏ ضمن واجھة المستخدم. 

استخدام نموذجي لربط الإعدادات هو أن يكون على التطبيق تذكر أين يظهر نموذج خاص على الشاشة عندما تم تشغيل التطبيق في المرة الأخيرة.تحفظ خاصية الفورم 
k0cation‏ موقع الفورم على الشاشة.تسجيل هذه القيمة إلى الإعدادات يتطلب خطوتين.أولاءإنشاء إعداد من نوع أ١أه۴.و١iسها0.صمstرSكلحفظ‏ قيمة الموضع 
المستديمة.ثانياًء الإشارة في خاصيات الفورم أن قيمة ذلك الموضع سيتم وصلها إلى مدخلة الإعدادات الجديدة. 

إتمام الخطوة الأولى يتم بإضافة إعداد مستخدم بمدى #۲ءلاونوع ”ذه ۴.وinسaاstem.Dرك‏ في لوحة الإعدادات كو١‏ 1ا86 لخاصيات المشروع.لنسميها 
Main FormPosition‏ ونترك حقل القیمة ue‏ اھ۷فارغ حالیاً. 

عد إلى محرر الفورم واختر كائن الفورم نفسه»ءومن ثم تمكن من الوصول إلى لوحة الخاصيات.مدد خاصية كو١1)‏ ۸56 0اه iاممA‏ لاإيجاد الخاصية الجزئية 
ertyBindingمpد۴r.بالنقر‏ على زر"..." لهذه المدخلة يعرض حوار إعدادات التطبيق.تظهر معالجة هذا الاختيار في الشكل التالي. 

اعمل على إيجاد مدخلة ١٥0اأهعم‏ في القائمة.واختر" 0نااsهە‏ ۴0۲"۴ Main‏ "من أجل قيمتها .حالياًكل مرة تشفل التطبيق فسيحوي هذا الإعداد المقيدستتذكر 
الفورم المعدلة موضعها السابق. 

الخلاصة. 
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كما مع 11 ×ءنظام إعدادات الدوت نت هو واحد من الميزات الداخلية. وخلف المشهد(غير مرئية).والتي تجعل البرنامج عظيم الاستخداء 


Application Settings Tor ‘Form! 


Bind properties Eo application settings: 


Font none}! 

ForeColor none}! 

ForrmBorderstyle none) E {Applicationsettings] 

HelpButtorı none] ک‎ {Property¥Binding}l 

ImeMode none} 8 Location none} 
IsMdikontainer nane) Text none) 


KeyPrewieyy none] {DataBindings) 
Lorzakiarı none] Name) Forml 


0 E E 


E) MainFormposition {PropertyBinding) 


Change and manage application sî none) Lhoase which properties Eo bind to configuration File settings. 


ا ا على إا إغاذات إلى روغ اكه في ةا الفل رى سو خا وتك هى م ك الأغذاذات ف ال التي اكلا ما ك وة اه 
بذلت جهداً كبيراً فيما إذا كنت سأستخدم قيم تركيب(إعداد)بمجال المستخدم ١عم٥ءء-۲هءدأو‏ بمجال التطبيق ١#م٥0ءء-0۸اةء‏ اام مه من أجل بعض الاإعدادات التي 
تتفير بشكل نادر.مثل نص اتصال قاعدة البيانات.قررت في النهاية استخدام إعدادات المستخدم لذلك يمكن تعديلها من خلال ميزات التطبيق.إن إعدادات مجال التطبيق 
settings‏ scoped-icationاApp‏ هي للقراءة فقط ویمکن تحدیتها من خارج البرنامج فقطلذلك تم إبعاد تلك الفكرة.المتوقع من إعدادات مجال التطبيق هو أن مدير 
النظام 0۴ stem administra‏ سيديرهاء إما باستخدام المفكرة على ملف ۷1× »أو من خلال أداة إدارية ما.بما أننا لن نضبع الوقت في مشروع هذا الكتاب لكتابة أداة 
اة فوا كط كل هى عله ضفخت المكة وة الل فن ال اة اة لري 


لنعمل على توثيق الاإعدادات المستخدمة من قبل التطبيق في مجموعة موارد المشروعاا۸ ء١۲ Ru‏ كء'اعهزهام .أضف المحتوى التالي إلى ملف معالجة نصوص 
مجموعة الموارد. 


يستخدم مشر وع المكتبة نظام إعدادات الفيجوال بيسك لتعقب قيم حالة معينة من قبل المستخدم والمحفوظة أتناء استخدام التطبيق.يتم تخزين هذه الإعدادات في ملف في 
دليل المستخدم sوہ/٤/مS cume ts ad‏ (أو ما يكافئه) في تنسيق يملى من قبل الدوت نت.التالي قائمة بالاعدادات المميزة من قبل مشروع المكنبة: 
DBConnection (String)‏ 

نص اتصال بتنسيق مناسب يحدد قاعدة بيانات سكول سرفر المستخدمة من قبل التطبيق.إذا ما فقدءفإن التطبيق سيسأل عن موقع قاعدة البيانات عند البدء. 

HelpFile (String) 

يشير إلى Uni frm Naming Convention (UNC‏ )أو موقع معتمد على حرف السواقة لملف تعليمات التطبيق الأساسي على الشيكة. مع الامتداد .٥۸/١‏ . 
HelpFile Admin (String)‏ 

يشير إلى N٥‏ لاأو موقع معتمد على حرف السواقة ٣‏ 0ناةعه! dمءهط-rمettا‏ iveاdلملف‏ تعليمات التطبيق الإداري على الشبكة.بالامتداد .٥۸/١‏ 
HideLogin (Boolean)‏ 

يشير إلى فيما إذا يجب أن يكون( زر "تسجيل الدخول"في الزاوية العلوية اليسارية للفورم الرئيسية لمشروع المكنبة) غير مرني عندما يكون العرض في نمط 
الزبون(العميل).استخدم صواب عں۲۲لاإخفاء الزر أو خطاً ما۴ لإظهاره.إذا ما فقد هذا الحقلءيتم إسناد خطأهءام۴ . 

MainFormPosition (System.Drawing.Point) 

موضع نموذج مشروع المكنبة الرئيسي على الزاوية العلوية اليسارية.وهذه القيمة يتم تحديثها كل مرة يتم إغلاق التطبيق. 

ReceiptPostlude (String) 

أية بيانات حرفية خام(أولية) ليتم إرسالها إلى الطابعة المستقيلة عند الانتهاء من كل بطاقة (تذكر ةأ )ءا ).يمكن أن يتضمن هذا النص الحروف الخاصة التالية: 

\n 


حرف سطر جدید(آسکي‌10: 10 ۱۱ا٥؟A8)‏ 
1 


حرف عودة المشيرة (آسكي13: 13 ١ا٥؟۸)‏ 
le‏ 


حرف هروب (آسکي27 : 27 ۱ا۸8€) 
x22‏ 


أي قيمة آسكي »حيث؟؟ شفرة ست عشرية لحرفين. 
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| 
رمز الشرطة المعكوسة(١)‏ 

ReceiptPrinter (String) 

اسم مسار الطابعة المستقبلة المستخدمة من قبل كمييوتر (أو محطة شبكية محلية)لطباعة وصل استلام مستخرجlت patron checkout receips Joe‏ ووصJ‏ 
nllدفgعlEٽreceipts payment‏ . 

ReceiptWidth (Integer) 

العرض”٣‏ اهنس .بالحروف.لكل سطر على الطابعة المستلمة.إذا كان فارغ أو مفقود»يستخدم البر نامج العرض الافتراضي 40 حرف. 

ReportConfig (String) 

يشير إلى ٥ل‏ لاأو موضع معتمد على حرف السواقة لملف ا ×تركيب تقرير .هذا الملف لديه تنسيق موصوف في مقطع "ملف تركيب تقرير" لهذا المستند..ويشير هذا 
الملف إلى التقارير المتاحة في التطبيق. 

SettingsUpgraded (Boolean) 

عند ترقية التطبيق من إصدار أقدم.تشير هذه اليافطة فيما إذا الاعدادات المصاحبة للاصدار الأقدم قد تم ترقيتها ضمن النسخة الجديدة.افتر اضاتها خطأً ماج۴ من أجل 
جميع الإصدارات. 

UseReceipts (Boolean) 

تشير فيما إذا الإيصالات المطبوعة يجب أن تستخدم في هذا الكمييوتر (الشبكة المحلية).إذا ما فقد هذا الحقلءيتم إسناد خطأً هكاه۴. 

هذا الوصف التقني يظهر في مستند مجموعة الموارد التقنية 7¬ r echnicaا Resource ۸¡† 0٥u‏ .بالأصل تم تطويرها في الفصل الرابع وتم تحديثها في الفصول 
اللاحقة.بعض المحتوى تم إضافته هنا بالاإشارة إلى أن المحتوى التقني والميزات لن يتم إضافتها حتى الفصول اللاحقةءلذلك لاتهدر الكتير من الوقت بالتفكير حول الميزات 
التي قد تظن أنك نسيتها. 


بما أننا نعلم جميع الاعدادات التي سنضيفها إلى التطبيقءدعنا نضيفها الآن. افتح نافذة خاصيات المشروع ك#ها همهم اعمزدام واختر تبويب "إعدlılت Settings‏ 
".أضف كل إعداد إلى التطبيق باستخدام الجدول التالي.فإذا كان الجدول لا يحتوي قيمة من القيم اترك حقل هذه القيمة فارغة كما هي في محرر الاإعدادات. 


( 
0n 
® 


DBConnection String 


e 
0n 
® 
= 


HelpFile Admin String 


MainFormPosition System.Drawing.Point User 


ReceiptPrinter String User 


& 
2 
® 
= 


ReportConfig String 


& 
0n 
® 
ا‎ 


UseReceipts Boolean False 


تأكد من كتابة اسم الاعداد كما تم جدولته.لن يكون التطبيق قادر على مطابقة الأسماء الفير صحيحة. 


لقد بينت لك كيفية وصل قيمة خاصية أداة أو فورم إلى واحدة من الإعدادات سابقاً في هذا الفصل.لذلك لنعمل على عمل هذا عملياً في المشروع.سنعمل على وصل خاصية 
موقع الفورم الرئيسي إلى إعدادہهن†زsءمە۴ص‏ اه۴ Main‏ .عادة تنشيط ذاكرتك اتبع الخطوات التالية لتمكين هذا الوصل. 

. MainForm. vb in Design Vie Waıoصڀڏتll 1.افتح الفورم الرئيسي في عرض‎ 

2.تأكد من اختيار الفورم نفسها وليس أحد أدواتها التابعة. 

3.في لوحة الخاصيlتProperties‏ .مدد lëllصية" ApplicationSettings‏ ". 

4.اختر الخاصية الفرعية" و"أ١”¡۷8ا۲ممها۴‏ "وانقر على الزر"...". 

5.حدد الخاصية " ١٥0اأةء‏ "في قائمة الربط . 

6.اختر الاعداد ٣siti0مP ain Form‏ من أجل قيمة الخاصية" ١٥اة٥ها".فستكون‏ الخيار الوحيد المتاح»بما أنها الوحيدة التي عرفناها من نوع 
.System.Drawing.Point‏ 

7.انقر الزر "موافق 0۸ " لتمكين الربط 


على الرغم من أنه حالما يتم إغلاق الإعدادات يتم كتابة " و”/٥77/١ء.sو”ه1y.S‏ "في الكود.بعض الاعدادات يمكن أن تكون بشكل أولي غير معرفةءويمكن أن 
يورط استخدامها بالكئير من الكود المكرر والذي يختبر صحة الإعدادات.لتقليل الكود ودوران المعالج بشكل عام»ستعمل على إخفاء بعض الإعدادات من أجل الاستخدام 
السهل على طول التطبيق. دعنا نضيف ثلاث متغيرات عامة لاإخفاء بعض الإعدادات.افتح الوحدة البرمجية 6/78/2/.۷6© وأضف هذه المتفيرات الثلاث كأعضاء لهذم 
الوحدة. 
Public MainHelpFile As String‏ 
Public MainAdminHelpFile As String‏ 
Public FineGraceDays As Integer‏ 
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لنمنح هذه المتغير ات قيم أولية في الطريقة٣٣#اءر؟هzاه |١‏ »حيث يعمل الكود على عمل إستاد أولي لبعض القيم الأخرى.أضف العبار ات التالية إلى ذلك الروتين في 
الوحدة البرمجية ا۴۲2"ه6. 
FineGraceDays = -1‏ 
E E ET‏ ر ا E‏ ا 
MainHelpFile = My.Settings.HelpFile & ""‏ 
MainAdminHelpFile = My.Settings.HelpFileAdmin & ""‏ 
في فصل سابق»عملنا على تخزين بعض الاإعدادات في الجدول ما۷٠‏ اءر8والذي يطبق على جميع الكمبيوتر ات(الشبكات المحلية) التي تتصل بقاعدة البيانات.بما أننا 
نعمل على إخفاء إعدادات على أية حال»سوف نضيف بعض الكود لإخفاء هذه القيم المخزنة في قاعدة البيانات لذلك ليس علينا الحفاظ على فتح وإغلاق قاعدة 
البيانات.أضف الطريقة كو”:)†مSمءaطهatم0‏ 4مم إلى الوحدة البرمجية اة۴۲"ه6. 
Public Sub LoadDatabaseSettings ()‏ 
اک عل ع ام کے لے CAN SS AS go SEEN at‏ 
Dim holdText As String‏ 
On Error Resume Next‏ 
ااا لے اا ا ا ا 
holdText = GetSystemValue ("DefaultLocation")‏ 
TE (Eola Texê > 7) Then ROLLIE < lU‏ 
DefaultItemLocation = CInt (holdText)‏ 
الحمول علي الحدة الاعف من اة ات اة 
holdText = GetSystemValue ("SearchLimit")‏ 
EE (HolGLexSE — N) Then MONSLESE — LIL‏ 
SearchMatchLimit = CInt (holdText)‏ 
امول عل حدد انام النتطار فقيل حرق ارامات '! 
holdText = GetSystemValue ("FineGrace")‏ 


EE (EOLATexXE <> I) Then HOlNAReXE < Ll 
FineGraceDays = CInt (holdText) 
End Süb 


سنعمل على استدعاء هذا الروتين خلال بدء تشغفيل التطبيق.تماماً بعد أن نفتح ونؤكد قاعدة البيانات.أضف الكود التالي إلى نهاية معالج الحدث 
ication_StartupاMyApp.‏ تذكر أن هذا المعالج موجود في ملف ط۷.ئ٤” 7٤۷٥‏ 0/اaء//400‏ »وهو واحد من الملفات المخفية عادة عن العرض في مستكشف الحلول. 
ET E E E a E O E E‏ 

LoadDatabaseSettings ()‏ 
حان الوقت لا ستخدام الإعدادات بشكل عملي.يشير الاأعداد ”وماع لا١۳.ءو”‏ ا هMy.S‏ فيما إذا زر"تسجيل الدخول ١أوها‏ "( «أومااءA)على‏ الفورم الرئيسية لتطبيق 
المكتبة سيظهر أم لا عند تشغفيل نمط غير المدير (أو غير أمين المكتبة).سبيقى المدير قادر إظهار الز ر "تسجيل الدخول "من خلال المفتاح ۴12»حتى ولو كان الزر 
مخفي.في بيئة ما حيث يكون المستخدم غير معروف»سيكون النظام بشكل صامت أكثر أمناً إذا ما تم إزالة إغراء ١٥هام"‏ 6ازر "تسجيل الدخول". 
يتضمن الروتين #۲ءل ۲ه ۴رهامءi‏ ممه ملفي فئة الفورم الرئيسية ۴٠۲۳١‏ كود من أجل نمط المستخدم(1- = 0١#۲ءل"المووها)ومن‏ أجل نمط 
المدير (1- <> 0١۲هءل‏ ”الم ووه1ا).في مقطع نمط المستخدم(المقطع الأول)ءبدل هذا السطر : 

ActLlLogin.Visible = True 

بالكود التالي: 


SEE EN OLE E REETE SEET TOD EET 
ActLlLogin.Visible = Not My.Settings.HideLogin 


ان الات غا ماك و لى اة ةه اعات ان الوعة ك اعات اة ل مى فيلت الأغواداة اة غه السك فاا 
توسبع النظام كو مء مidس-صعاكرء‏ المخزنة في قاعدة البيانات.معظم الاإعدادات بسيطة جدا»مجرد نصوص أساسية. أعداد.وعلامات منطقية»لذلك فلن تربك المدير 
إذا ما ظهرت جميعها في فورم مفرد. ولكن قبل أن نذهب إلى تلك الفورم»سنعمل على إضافة فورم تتيح لنا إدارة اتصال قاعدة llزييlنlٽ database connection‏ . 

أفكر في استدعاء حوار خاصية الاتصال وەاهiك connection مroمpم is‏ التي تستخدمها الفيجوال بيسك لتأسيس نصوص الاتصال.إني واثق من أنها ممكنة»ولكنها 
توفر طريقة أكثر مرونة من التي نحتاجها في هذا المشروع.فهي تدعم التركيب على قاعدة بيانات غير تابعة لسكول سرفرءوالتي هي غير مهمة بالنسبة لمشروع 

الك رو كال اتا مكل سر تى اما وة كت اكول عة لهات الى عة ات اك فكي اذا 

بالمقابل سنعمل على تصميم نموذج أبسط يعمل على تجميع فقط قيم البيانات التي نحتاجها ليناء نص اتصال قاعدة البيانات.الفورم مءaطةة#0اهءه‏ اكما يظهر في الشكل 
التالي. 
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تحنيد المخدم(الحهازاالذت توجد عليه قاعدة بيانات المكتبة.يدعم مشروع 
لصستبة قاعدة بیانات سکول سرقر 


SS n 


اسم فاعدة البيانات! | 
التصحيف ! 
اتر التيسيانقدم: 


كلمة المرور: 


عملت على إضافة هذه الفورم إلى المشروع(راجع مشروع هذا الفصل).افتح الملفط۷.٥b2sةاة2 1٠٥216‏ لرؤية هذه الفورم.أربع من حقول هذه الفورم مجرد حقول 
لمدخلات نصية أساسية( واحد مع حروف قناع كلمة المرور(بحيث لا تظهر حروف كلمة المرور ويظهر عوضاً عنها رموز مثل رمز النجمة).حقول المدخلات 
الخمسة.فالتصدیق» یتیج للمستخدم الاختیار بین تصدیق ميکر وسوفت ویندوز Microsoft Windows auth e) C2|0۸‏ وتصدیق سکول سرفر SQL S€V8۲‏ 
uthenticationه.معظم‏ كود الفورم متوافق لما قد رأيناه في العديد من النماذج الأخرى في السابق.واصل العمل الآن وأضف جميع الكود إلى الفورم الآن. 
يحدث العمل الهام في هذه الفورم في حدث التحميل 4١4٠اعندما‏ يتم ترجمة نص الاتصال الموجود ضمن حقول إدخال البيانات لمختلفة.وفي الروتين ۲هءلام٣۳١٣۴حيث‏ 
يتم إعادة وضع الأجزاء مع بعضها البعض. 
توجد عدة طرق مختلفة تمكنك من قطع(تقسيم) نص الاتصال ضمن الأجز اء القاعدية.لقد أخذت القاعدة الأساسية فرق تسد 8۲ا iVi e-2 Nd-c0‏ »مستخرجاً كل 
مكون مفصول بإشارة مساواة وفاصلة منقوطة. راجع مقطع معالج حدث تحميل هذه الفورم والتي تعمل قطع (تقسيم) و استخر اج: 
iE UY LOCOS DEEASESS_ LOC‏ 
على الرغم من أن الفورم مك2طهاة۵0اهءهاتقوم بجميع الترجمة والبناء لنص الاتصال»فهي لا تعمل عملياً على تحديث الإعدادات المحفوظة.بالمقابل.تعمل على إرجاع 
نص اتصال تم بناءه حديثاًء وتعتمد على الكود المستدعي لحفظه. 
الآنءعد إلى محرر تركيب نموذج مفر د الفورم.8.۷6٥۸2/7‏ ۸/2/18 .فهذا الفورم يعمل جمبع التعديل على القيم في كل من قاعدة البيانات وبنود كو٧اا†مMy.S‏ 
المحلية.يبين الشكل التالي لوحتين رئيسيتين على هذا النموذج.الاإعدادات الممركزة المخزنة في قاعدة البيانات هي"توسيع النظام #لİس-عاءرء‏ "والقيم" خاصة بالجهاز 
أو محطة العمل عأ ممء-workstation‏ "هي تلك التي يمكن الوصول إليها من خلال sوہ٤My.Se.‏ 
]الان 
الموقة الافتراضي لبند؛ 
لبجاذ أيام الإعفاء: 


النصنيفا: 


یمگن للزبائن استخراج بند بأنفسهم 
التالي عدد لصاحات القيم الشاملة 
من أجل لصاقات بند الصكنبة: 
من أجل لصاقات الزبون: 
من أجل اللصاقات الضتنوعة: 


اسم خط القيصة الشاصلة؛ 


کود ۳۹ او من ۹4 


يبدأ هذا النموذج عمله في معالج حدث التحميل0هها »وهذا الروتين يثبت الخيارات في بعض الحقول المنسدلةمتضمناً قائمة الخطوط .يدور الكود خلال تجمبع الخطوط 
المنصبة جاعلا إياها متاحة من خلال .System.Drawing. Text.InstalledFontCollection :GDÖ| J| jil‏ 
Dim allFonts As New System.Drawing.Text. InstalledFontCollection‏ 
RecordFontName. Items.Add (New ListItemData ("<Not Selected>", -1))‏ 
HO Coun EeE = O TO aLIHONES.EAaMI IES LeRIEN‏ 
RecordFontName. Items. Add (New ListItemData(allFonts.Families (counter) .Name, counter) )‏ 
NEXE CEOUNEG E‏ 
يتضمن الروتين أيضاً كود مشابه لتحميل قائمة الطابعات المثبتة. 
For Each installedPrinter As String In PrinterSettings.InstalledPrinters‏ 
RecordPrinterLocation. Items.Add(installedPrinter)‏ 
Next installedPrinter‏ 
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حالما يتم تثبيت كل شيءءيعمل الإجراء ءعںاateCurren1۷aاuمpد‏ على إكمال التمهيد .فيعمل كوده على استخلاص جمبع القيم الحالية من قاعدة البيانات ومن الكائن 
5و My.Se.ويخزن‏ هذه القيم في حقول إدخال البيانات المتنوعة على الشاشة. لقد عملت على إضافة الكود الخاص بقاعدة البيانات.تابع واعمل على إضافة الكود 
الخاص بالاعدادات. 
LibraryConnection = My.Settings. DBConnection & ""‏ 
RecordDBLocation.Text = GetDBDisplayText (LibraryConnection)‏ 
RecordConfigLocation.Text = My.Settings.ReportConfig & ""‏ 
RecordBasicHelp.Text = My.Settings.HelpFile & "™"‏ 
RecordAdminHelp.Text = My.Settings.HelpFileAdmin & ""‏ 
EnableReceipts.Checked = My.Settings.UseReceipts‏ 
ReCOLABEINEerLOCaAEION . TExXE > My.Seltltings .REeCe1LELINnEeE ¢ LT"‏ 
RecordPrinterWidth.Text = CStr (My. Settings. ReceiptWidth)‏ 
RecordPostlude.Text = My.Settings. ReceiptPostlude & ""‏ 
HideLogin.Checked = My.Settings.HideLogin‏ 


قاعدة بيانات الصكة! 
ټرکیب تقرور: 
ملغات المصاعدة عبر النت 


مستخدم عادي: 


مستخدم مخير؛ 


بطاقات الاصتلام 


تمكين طباعة وصل على هذا العماز 
تحديد الطابجة المستلمة: 
عرض السطراالحروف): 


تففية الاستللام؛ 


بحت كبر الشبكة عن مساعدة من أجل رموز تكعلة محيدة. 


إخفاء زر تسجيل الدخول عن الزبائن 


معظم الكود في هذه الفورم يتعامل مع تفاعل المستخدم العادي بينما يكون الفورم قيد الاستخدام.على سبيل المتالءمعالج حدث الزر ActDBLocation_Click‏ يعرض 
نموذج"موقع قاعدة البياناتهءةطهاة2ءاهءها " الذي أضفناه سابقا.أضف الكود المصدري المناسب إلى معالج الحدث هذا. 
EriIvate SUS ACLDELOCA EI ON CIA CEKEN SEenNIJEE AS SMSEEOM OSNECE, Eval E AS SVS EOM  EVUERNEAEIS) Handles‏ 
ACE DBLOCaAE TORN. CEI TEK‏ 
Prompt for the database connection details.‏ جحد ا 
Dim newConnection As String‏ 
E Prompt the user for the new setting.‏ 
newConnection = LocateDatabase. PromptUser ()‏ 
If (newConnection = "") Then Return‏ 
Sm Store the new value.‏ 
LibraryConnection = newConnection‏ 
RecordDBLocation.Text = GetDBDisplayText (LibraryConnection)‏ 
End Sub‏ 
تعين العديد من الاعدادات موقع الملفات المستخدمة من قبل التطبيق.مثل ملفات المساعدة عبر النت»يمكن للمستخدم أن يكتب في المسار دليل الملف» أو يستخدم حوار فتح ملف لتحديد الملف 
بشكل مرئي.لعرض الحوار.عملت على إضافة أداة "حوار فتح ملف وه‌اه5i٥!ا۴”‏ مم0 "مسماة ۵ا|۴هاaع10ا.استخدامها‏ هو موضوع إعدادات الخاصيات تعين ملف المتنوعة واستدعاء 
الطريقة وهاها2سه"S.(راجع‏ الكود المضمن في معالج حدث )نا٤‏ _مام1ءاsه‏ 18ء۸ المستخدم لإيجاد ملف المساعدة الفير إداري عبر الشيكة والذي يبدأ بالكود التالي© 
BEA Ee EUS AOEBESIEHE LS CEO‏ 


حالما يكون المستخدم قد عمل الاإعدادات تفيرات على الاإعدادات المتنوعة»يؤدي النقر على الزر"موافق" إلى حفظ كل إعداد جديد لمنطقة حفظه.عملت على تضمين كود 
الحفظ المعتمد على قاعدة البيانات في الروتينة†ة 5۷۵۴٠١2‏ .وسأتيج لك إضافة كود معتمد على الإعدادات .قرب نهاية الروتين.(راجع هذا الكود الذي بدايت© 
Private Function SaveEFormData () As Boolean‏ 
على الرغم من أن الفورم6٤‏ 2٠ا١‏ "صيانة"توفر واجهة قريبة من المستخدم للاعدادات المخزنة في قاعدة البيانات.من المحتمل أن تتذكر أننا كتبنا سابقاً كود 
تحديث سجلات جدول"قيم النظام مuاة۷٠ءاءرS‏ " من خلال الملفط .م ۷2/uع1ئرك‏ .في الفصل 12.ءلقد وصلنا تلك الفورم إلى الفورم الرئيسية»ولكن نحن الان 


.ActallValues_Click ثدحنlا ذاهبون لتغير ذلك المنطق.أولاءسنعمل على إضافة استدعاء إلى نموذج"قيم النظام مuاة۷ءاءرS " من "نموذج الصيانة" في معالج‎ 
Erivatê SUS AELAL IVa UES CIT CENEBVUS U Sender AS SVS EO COON ECE, BUN E AS SVSEOMS EMERNERESS) HESRILES 
ActAllValues.Click 

Let the user edit the list of system values.‏ صت ا 
Dim RecordsForm As LIBRARY.ListEditRecords‏ 

٣ ڪڪ‎ Edit the records. 

RecordsForm = New LIBRARY.ListEditRecords 
RecordsEorm.ManageRecords (New LIBRARY. SystemValue) 
RecordsForm = Nothing 
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ومن ثم سنعود ونغير معالج الحدث )نا۳ )م1 ا_uesا۷a minin)‏ في الكود المصدري للفورم الر ئيسية۷6 121١۸۴0۲٣.‏ . حالياً« يستدعي محرر SystenValue‏ 
مياشرة.غيّر ذلك الجزء من كود معالج الحدث بالكود الذي يستدعي النموذج "صيانة" بدلاً عنه. 


التفير الأخير في هذا الفصل يستخدم نص الاتصال المركب لتأسيس الاتصال إلى قاعدة البيانات.عندما كتبنا روتين مك2طهاة12ءه" ۸ه بالأصل في الوحدة البرمجية 
Gene‏ .عملنا على إضافة نص اتصال ثابت من أجل جعل البر نامج يعمل فقط 
ف اكتف ا لافطال .اة في الوقت الحالي 
connectionString = "Data Source=MHM\SQLEXPRESS;" & "Initial Catalog=C:\Program Files\Microsoft SQL‏ 
Server\MSSQL.1\MSSQL\Data\library.mdf; Integrated Security=true"‏ 
الآن متاح لدينا نص اتصال مركب من قبل المستخدم سنعمل على استخدامه بدل المذكور في الأعلى.التفيرات التي يجب أن نعملها لهذا الروتين نوعاً ما واسعةءلذلك قم 
فقط بتبديل فقط محتوى الدالة بالكود التالي: 


BUDE E 


Dim 
Dim 


OE 


Then Return False 


New 


Then Return False 


Then 


True 
End HURE EA OM 


اذا ات SÛ os‏ "حاج إلى عمل التغیر ات في الروئین 056 ۶۳۰۳ في كود القورم"تحديد 
قاعدة البيانات ca 02ba‏ 10ا".قم بجعل السطر التالي تعليق: 
EEN CORRE SEO E CEG CECE Ey ESEN‏ 


واجهل أيضاً السطر التالي تعليق: 
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'newConnection &= ";User ID=" & Trim (RecordUser. Text) & ";Password=" & Trim (RecordPassword. Text) 

واعمل التغفيرات التالية في السطر التالي: 

newConnection = "Provider=" & Trim (RecordServer.Text) & ";Data Source=" & Trim (RecordDatabase. Text) 
ءل . ٤٥5١ء .في حقل المخدم/المضيف »اكتب مسار قاعدة البيانات في حقل "اسم قاعدة البيانات" على سبيل المتال توجد‎ . 01٨08 . 4.0 والآن اكتب الموفر‎ 
. C\Documents and Settings\Administrator\library.mdb:"تlنlqييلl قاعدة البيانات عندي على المسار التالي والذي سأكتبه في حقل "اسم قاعدة‎ 
ومن ثم انقر موافق.‎ 
الا مر ءاوالا ساسي في الكود هو أن الاإعداد يتضمن المتغير و” |۸58۲ هoااءممnهء لنص الاتصال المصمم ك اءاءاهم »ويستخدمه لفتح الكائن ۲4۲۷58طا.يحصل‎ 
إذا ومن أجل أي سيب تم فقد نص الاتصال أو فشل في توليد فتح اتصال لقاعدة البياناتءيتم‎ . My.Settinوs.DB‎ Cone ان0٣ الكود الجديد على نص الاتصال من‎ 
.امcate0aab2se الطلب من المستخدم توفير نص اتصال صحبح من خلال الفورم‎ 
يعود البرنامج إلى الحالة بحيث تستطبع تشغيله مرة أخرى.في المرة الأولى التي تشفل فيها التطبيق.فإنه سيطلب من المستخدم تزويد معلومات الاتصال بقاعدة البياناتء‎ 
.ConnectDatabase القيم التي توفرها يجب أن تطابق الحالة التابتة الموجودة في الروتين‎ 
إذا كنا نستخدم موفر سكول سرفر فيجب أن يكون التالي(لكن لاتنس أنني في المشروع استخدم مخدم أكسس فلا تختلط عليك الأمور):‎ 
أو إلى اسم مضيف سكول سرفر الفعلي الخاص بك.‎ " N YSERVER\SQLEXPRESS " إلى‎ Server/H4 05 .ضع المخدم/المضيف‎ 
.ضع اسم قاعدة البيانات إلى " ر٣۲2 طنا " أو أي اسم قمت بإسناده سابقاً كاسم لقاعدة بيانات المكتبة.‎ 
.إذا كنت بحاجة إلى‎ Windows integrated secu "!ذا کنت تستخدم آمن ویندوز المتکامل راا‎ Microsoft Windows " إل‎ Authentica i0 ^ .ضع التصدیق‎ 
. 855W0۲لةحيحص ا5۵ ".وأدخل اسم مستخدم صحيح 0| وكلمة مرور‎ S٠١۷8۲ " استخدام نظام أمن سكول سرفر»ضع هذا الحقل إليه أي‎ 
سنركز في الفصل القادم على تقنيات معالجة الملفات.على الرغم من أنني عملت على تحديث ملف الإعدادات في هذا الفصلءفقد تم عمله بشكل غير مباشر من خلال‎ 
الميزات الموفرة من قبل إطار عمل الدوت نت.سيناقش الفصل15 قواعد مباشرة أكثر خاصة بمعالجة الملفات.‎ 
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lالملفات‏ وlںدlة Files and Directories‏ 
تطور البرمجيات في بداية القرن الحادي والعشرون حول المبرمجين حقاً إلى مجموعة من الحالمين(ل أقصد التلاعب بالألفاظ).في الأيام القديمة للكمبيوتر »كان على المطورين ربط 
البرامج إلى الكمبيوتر يدوياً.فيمكن لحسابات معقدة أن تأخذ أيام لاعدادها.كانت المعاناة حقيقية, والقضايا الأقدم للالكترونيات الشانعة يتم غربلتها بالمواضيع من قبل المبرمجين 
السابقين والذين كانوا مولعين في محاولتهم لصناعة خوارزمية حساب أكثر دافعية ومنهجية. 
تطورت الحياة بشكل هائل بالنسبة للمبر مجين عندما اقترح جون فون نيومان وآخرين أن باستطاعة الكمبيوتر تخزين المنطق للخوارزميات بشكل داخلي»ومعالجتها مياشرة من 
الذاكرة بدلاً من التركيبات الصعبة المثيرة في كل مكان.عمل المبرمجين مباشرة على وضع برامجهم ضمن مجموعة كروت وأشرطة ورقية.حتى جاء اختراع الهارد ديسك(القرص 
الصلب) والتقنيات المتعلقة به. 
وهكذا كانت ولادة نظام الملفات #٠‏ اء5۷ه!اا؟ » المخزن التر كيبي للبر امج والمعلومات على سطح الديسك(القرص). #٠٣5‏ ۴|55 أنظمة الملفات قد أصبحت جزء من تقنيات 
ميکر وسوفت منذ تودد بيل غيتس للمرة الأولى ل أي بي إم۱8 .لم يكن صدفة أن يرمز الدوس 008 في میکروسوفت دوس ۱8-008 إلى قرص نظام تشغيل )ء2 
0er2 nو System‏ . عرف بل كيف كانت أنظمة الملفات الأساسيةءوكذلك أنت.في هذا الفصل »سوف نتكلم حول التفاعل مع الملفات والأدلة.والوحدات الرئيسية التخزينية 
والتنظيمات في نظام ملفات ويندوز "۳عاء/5هاا؟ ۷100۷5 .وسنرى أيضاً أن بعض تقنيات وميزات الدوت نت توفر معالجة للملفات ومحتوياتها. 


عملت الفيجوال بيسك على تضمين ميزات إدارة الملف الهامة منذ الإصدار الأول.في الحقيقة.توجد ميزات في الفيجوال البيسك تتعامل مع معالجة ملف #اأ؟ودليل هاه di‏ 
أكثر نسبياً من أي شيء أخر.معظم الدوال التي تسمج لك بقراءة وتعديل محتوى ملف تستخدم معالجة ملفه/۵” ۸2 7/٥‏ »ومعرفات عددية um ic i٣٤٥۲‏ ہم تشير إلى ملف 
مفتوح نوعي.ومعالج الملف ءال٣2٣‏ ٠اا‏ هذا يتم توليده بالدالة ۵أ۴٠٠۴۲.‏ ويجب أن تسود قبل استدعاء أي ميزات ملف فيجوال بيسك تقليدي. 
Dim filelD As Integer‏ 
fileID = FreeFile()‏ 
KIA NeOBDORN E le ID, TCE SEDUa EA. EXE, OBenUMSde. ASDBEeRNG)‏ 
BERE NENRE LEL D, CIMSOEEANE OUEOUE EO EAI. ©)‏ 
ENeECLOSeE (ELIC ED)‏ 


تعمل معالجة ملف معتمدة على معالج ملف بشكل جيد»ولكنها قديمة جداءوحقيقة ليست تقنية دوت نت.وليست معتمدة على كائن على الإطلاق(مالم تعتبر أن الاإنتفر ٣#وها”!كائن).‏ 
وبالتالي فلن أغطيها في هذا الكتاب» أو استخدمها في مشروع المكنبة.يجدول الجدول التالي ميزات الفيجوال بيسك الرئيسية والتي تستخدم معالجات ملف.إذا كنت تريد معرفة المزيد 
حول الميز ات المعتمدة على المعالجة في الفيجوال بيسك أو إذا كان عملك بتضمن ترحيل تطبيقات فيجوال بيسك سايقة إلى الدوت نت»استخدم هذا الجدول لمساعدتك في إيجاد 
تفاصيل الميز ات الكاملة في المستندات التقنية المزودة مع الفيجوال بيسك. 


Visual Basic features that use file handles 


Feature Description 

EOF Returns a Boolean indicating whether the current position in the file is at or past the end 
of the file. Use this function to determine when to stop reading existing data from a file. 

FileAttr Accesses the file attributes currently set on an open file handle. 

FileClose Closes a specific file opened using a file handle. 

FileGet Retrieves structured data from a file and stores itin a matching object. 

FileGetObject Same as FileGet, but with slightly different data typing support. 

FileOpen Opens a file for input or output. 

FilePut Writes an object to a file in a structured manner. 

FilePutObject Same as FilePut, but with slightly different data typing support. 

FileWidth Sets the default line width for formatted text output files. 

FreeFile Returns the next available file handle. 

Input Retrieves a value previously written to a file using Write orWriteLine. 

InputString Retrieves a specific number of characters from an input file. 

LineInput Returns a complete line of input from a file. 

Loc Returns the current byte or record location in the file. 
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Lock Locks a file or specific records in a file so that others cannot make chandes. 
LOF Returns the length of an open file, in bytes. 

Print Sends text output to a file. 

PrintLine Sends text output to a file, ending it with a line terminator. 

Reset Closes all files currently opened with file handles. 

Seek Gets or sets the current position in a file. 

SPC This function helps format text for output to columnar text files. 

TAB This function helps format text for output to columnar text files. 

Unlock Removes locks previously set with Lock. 

Write Writes data to a file using a consistent format that can be easily read later. 
writeLine Same as Write, but ends the output with a line terminator. 


يتضمن إطار عمل الدوت نت مقاربة موجهة بالكائنات لقراءة وكتابة الملفات:التجميعاتء”/4ع/1ء .كائن التجميع 5١٠4۳‏ المجرد موجود في 4۳ه0.5|.٣ءلرS؟»‏ ويعرف 
وسيط ٥١‏ ه؟۲هاہاشامل لقطعة كبيرة من البيانات.ولا يهم مكان البيانات:في ملف أو في مقطع من الذاكرة.أو في متفير نصي #اطة١۷2۲‏ و1 إذا كان لديك مقطع من البيانات 
يمكنك من قراءة أو كتابة بايت واحد في كل مرةءفتستطيع تصميم فئة تجميع مشتقة 5Sكهاء‏ 4١ء‏ ١۷٣هل‏ للتفاعل معه. 


تتضمن الميز ات الاأساسية لكائن ستريم ۳ه٠ء)8طرق‏ قراءة #٠2١‏ وكتابة #ان۷۲والتي تتيجح لك قراءة أو كتابة وحدات تخزينية #5ار6.بما أن البيانات هي قراءة من أو كتابة 
إلى تجميع ستريم"٣‏ 4٠ء5‏ .فإن كائن الستريم يحفظ "الموضع الحالي١0اائمم‏ ٤٣٠٣٣اء‏ "ضمن الستريم والذي تستطيع تعديله باستخدام الطريقة "بحث )هم5 ".أو التفحص 
باستخدام الخاصية "موضع ١٥ااوه۴‏ ".تشير خاصية "الطول ١٤و١٠ا‏ "إلى حجم البيانات القابلة للقر اءة.تعرض الفئة أيضاً انحر افات عن هذه الميزات القاعدية لاإتاحة المرونة 
قدر الإمكان. 

ليس كل ستريم يوفر كل الميزات.بعض الستريمات للقر اءة فقطرا٣ه-كه٠۲‏ . وبعضها للأمام فقط را٣ه-ل٣‏ 2س ه0؟التركييات التي لاتدعم الكتابة و١ذاا٣‏ أو البحثوہi)همء‏ . 
تجميعات أخرى تدعم جمبع الميزات الممكنة.الميز ات المتاحة لك تعتمد على نوع الستريم(التجميع) الذي تستخدمه.بما أن الستريم نفسه مجرد.فيتوجب عليك إنشاء حالة من فتاته 
المشتقة.تعرف الدوت نت عدة ستريمات مفيدة جاهزة 

تجمبع ملف FileStream.‏ 

كائن ۳ه٠١51ا۴يتيح‏ لك الوصول إلى محتوى ملف باستخدام الطرق القاعدية لفئة ستريم الشاملةككهاء صهءء)S‏ امهو .وهي كائنات تجميع ملف تدعم القراءة ۲۴2١٣9‏ 
الكتابةو١‏ اأ .والبحث و١‏ )٥ء‏ .على الرغم من ذلك إذا فتحت ملف للقراءة فقطهاا؟ راه- ٠20‏ .فلن تكون قادر على الكتابة له. 

MemorySiream. öركlJl‎ goجت‎ 

تجميع معتمد على مقطع من صفوف الذاكرة.تستطبع إنشاء تجميع ذاكرة بأي حجم»وتستخدمه بشكل مؤقت لتخزين واستخراج أي بيانات. 

NetworkSiream.ةكıiلJ|‎ عıمجت‎ 

تجرد هذ الفئة البيانات القادمة من مقبس أ6)ء 0ء شبكة ما.بينما معظم فئات ستريم المشتقة تقبع في 0|.١٠٠ءرS‏ ءفإن هذه الفئة تقبع في 

.Syst‌em.Ne.0ckets.Buffered Stream‏ تضیف دعم تخزین انتقالي 8۲٣9‏ ؟لاط لستريم لتحسين الأداء على الستريمات مع قضايا الكمون(مشاكل الخفاء).إنك تطوق 
الكائن ۳ 4٥re۵81rءff 8u‏ حول ستريم أخر لاستخدامه. 

CryptoStream gıaجت‎ JJإ التشفیر‎ 

يسمح لك هذا الستريم إرفاق موفر خدمة تشفيرءينتج عنها مخرجات مشفرة من مدخلات بسيطة, أو العكس بالعكس.يتضمن الفصل 11 أمثلة تستخدم هذا النوع من الستريم. 
DeflateStream a/d GZipStream‏ 

يتبج لك استخدام ستريم لضغط أو فك ضغط بیانات عندما یتم معالجتھاء وکلها تستخدم خوار زميات ضغط يlېيmsa standard compression alg0rit^‏ . 
الستريمات(التجميعات)مفيدة بحد ذاتهاءولكن تستطبع أيضاً ضم تجميعات(ستريمات) بحيث يمكن أن يتم بشكل مباشر تشفير ستريم شبكة.ضغطه وتخزينه في مقطع تجمبع(ستريم) 
ذاكرة. 


استخدام ستريم بسيط أولاً عليك إنشاءه ومن ثم تبدأ بقراءة وكتابة البايتات 5هارطلليسار واليمين.إليك كود بسيط ينقل البيانات إلى ومن ستريم ذاكرة.وهو معتمد على كود ستجده 
في مستندات میکر وسوفت .MemoryStream ةidl (SDN‏ 
The Stream, or There and Back Again.‏ ڪڪ ل 
Dim position As Integer‏ 
Dim memStream As 1I0.MemoryStream‏ 
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Dim sourceChars() As Byte 
Dim destBytes() As Byte 
Dim destChars() As Char 
Dim asUnicode As New System. Text.UnicodeEncoding () 
کے کے سے کے‎ Create a memory stream with room for 100 bytes. 
ر اک ال 100 ادت‎ 2 
memStream = New I1I0.MemoryStream (100) 
ES Conve Ene Lezk Jalê ES 4 OVUES AEE, 
E E e O E N ENN OE 
sourceChars = asUnicode.GetBytes ("This is a test of the emergency programming system.") 
EY 
ا‎ Store the byte-converted data in the stream. 
اا ا ا د ا‎ 
memStream.Write (sourceChars, 0, sourceChars.Length) 
ر‎ The position is at the end of the written data. 
SCN N CE NN 
' To read it back, we must move the pointer to 
'" Ene Start aGaIn: 
ر اکریه‎ N N N ES EOE DEN O CCR 
memStream. Seek (0, IO0.SeekOrigin. Begin) 
1 ج‎ Read a chunk of the text/bytes at once. 
ا م کر ات جا‎ 
destBytes = New Byte (CInt (memStream. Length)) {} 
position = memStream. Read (destBytes, 0, 25) 
کت د‎ Get the remaining data one byte at a time, 
SESE EOE EU 
کال او و رن ال اا‎ 0 0 A O N E AL 
While (position < memStream. Length) 
destBytes (position) = CByte (memStream. ReadByte () ) 
BDOSIEION 1 
End While 
E Convert the byte array back to a set of characters. 
اال مدو سات مره ری ان جاع جروت‎ 
destChars = New Char (asUnicode.GetCharCount (destBytes, 0, position)) {} 
asUnicode.GetDecoder () .GetChars (destBytes, 0,position, destChars, 0) 
س‎ BPEove that the Cex 1s DoCK. 
ات ان ا ت اا‎ 
MsgBox (destChars) 
Ema ll y 
memSstream. Close () 
ENA TEY 


على أمل أن تكون التعليقات قد جعلت الكود واضح.بعد إنشاء تجمبع ذاكرة "۲۴2۳ء إ٣اه"‏ ه6" .وضعت مقطع من النص فيه»ومن ثم قراءته باستر جاع (بطريقة تراجعية).( يبقى 
الل ى ا ا د ف كد ها ق اوه ا الا وال واو ا و 


بالنسبة لي»كل تلك التحويلات بين البايتات والحروف لا تستحق الاهتمام.فعندما أكتب تطبيقات عمل.فإنني أتعامل بشكل نموذجي مع التواريخءالأعداد والنصوص:أسماء الزبائنء 
تاريخ الطلبية.كمية المدفوعات.وهكذا.نادرآً ما يكون علي العمل على مستوى البايت.على الرغم من أنك تستطبع معالجة الستريمات مباشرة إذا كنت تريد أو تحتاج حقاً لذلك. ففضاء 
الأسماء ۱0.”ءاءركيتضمن أيضاً العديد من الفئات والتي توفر منطقة فاصلة(انتقالية) أكثر قرباً للمستخدم بينك وبين الستريم.يتم تنفيذ هذه الفثات كقارئات ٠٠4۵6۲5‏ وكاتبات 
r5‏ مميزة لبيانات ستريم الذي يوفر طرق مبسطة لتخزين أنواع بيانات معينة»واستخر اجها مرةً أخرى.يتم تصميم القارنات من أجل اتجاه واحد معالجة البيانات تتم من البداية 
إلى النهاية.بعد إنشاء أو إمكانية الوصول إلى الستريمءفإنك تفلف ذلك الستريم إما بقارئ أو كاتب»وتيدا اجتياز نطاق الستريم من البداية.عليك دائما الوصول إلى الستريم الضمني إذا 
كنت تريد تحكم ذو قابلية أكير للتعديل عند أي نقطة. 


تجعل هذه الفثات من السهل كتابة وفيما بعد قراءة أنواع بيانات الفيجوال بيسك الاأساسية إلى ومن ستريم غير نصي(بشكل عام).تتضمن الطريقة 81٣2۲۷۷۷٤۵۲۰۷٥‏ إعادة 
تعريف لكتابة بايتات»حروف وانتغر بإشارة أو بدون إشارة ويأحجام متنوعة, البولين(المنطقي)ء العشريء النصوص, والمصفوفات ومقاطع بايتات وحروف.ومن الغريب عدم وجود 
إعادة تعريف |٥24‏ 0veلقيم‏ التاربخ .502e‏ 

يتضمن النظير ٠20٥۲‏ ۸ه ”8 الطريقة المنفصلة ۸٠۵١‏ من أجل كل نوع بيانات قابل للكتابة.ترجع الطريقة مااuم R440‏ قيمة eاطنام0من‏ الستريم»وتوجد طرق مشابهة من 
أحل أبواع البانات الاك 


تستخدم هذه الفثات بشكل نموذجي لمعالجة ملفات نصية معتمدة على سطر .تتضمن الفئة ۸٠40۴"‏ "ه٠5‏ الطريقة ٠١‏ اال ه۸6 والتي ترجع بالسطر التالي في النص في الستريم 
القادم كسلسلة نصية و١‏ ٠ء‏ قياسية. تتضمن الطر يقة عا ۷/۲.۷ S4‏ ذات الصلة كل إعادات التعريف Binary riter.Write Jove ا٥ ads‏ ولديها أيضاً نسخة(إصدار) 
يتيبح لك تنسيق نص من أجل المخرجات.يتضمن القارئ ٠٠۴206١‏ ميزات تتيج لك قراءة بيانات حرف حرف. مقطع مقطع, أو كامل الملف في نفس الوقت. 
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يوفر هذا الزوج من الفئات نفس الميزات التي يوفرها الزوج te۲ وS†”ءه "R26۲‏ mWصSirea.ولكن‏ يستخدم حالة سلسلة حرفية و١1٣5‏ قياسية من أجل تخزين البيانات بدلاً 
مڻ فل 
يوفر زوج إضافي ۲٥20ء‏ 8×٠۲و re» rite‏ فئة قاعدية من أجل القارئات والكاتيات الغير تنائية الأخرى.تستطبع إنشاء حالات منها بشكل مباشرءولكنها تتيح لك معاملة حالات 
السلسلة الحرفية والستريم للقارئات والكاتبات بشكل عام.بهذه الأدوات الجديدة .من الأسهل معالجة البيانات غير البايت من خلال الستريمات.إليك إعادة كتابة كود ستريم الذاكرة 
والذي کتبته سابقاًءوالمعدل من أجل استخدام قاری وکاتب ج>دJزي StreamReader and Strea Writer‏ . 
The Stream, or There and Back Again.‏ ڪڪ ا 
Dim memStream As IO0.MemoryStream‏ 
Dim forWriting As IO.StreamWriter‏ 
Dim forReading As 10.StreamReader‏ 
Dim finalMessage As String‏ 
Dim asUnicode As New System. Text.UnicodeEncoding ()‏ 
Create a memory stream with room for 100 bytes.‏ ححص ا 
memStream = New IO0.MemoryStream (100)‏ 


EE 
i Wrap the stream with a writer. 
forWriting = New IO.StreamWriter (memStream, asUnicode) 
حص‎ Store the original data in the stream. 
forWriting.WriteLine ("This is a test of the emergency programming system.") 
FOEWEN E1nG .EIUSR (J) 
و ا‎ The position is at the end of the written data. 
' To read it back, we must move the pointer to 
' Ene SEALE AGAIN 
memStream. Seek (0, I0.SeekOrigin. Begin) 
ج‎ Create a reader to get the data back again. 
forReading = New IO0.StreamReader (memStream, asUnicode) 
جد ا‎ Get the original string. 
finalMessage = forReading.ReadToEnd () 
کچ‎ Prove that the text is back. 
MsgBox (finalMessage) 

Finally 
memSstream. Close () 

EDO TEY 


من المؤكد أن هذا الكود أفضل بكتير من جمبع التحويلات في الكود السابق والذي يجعل العمل في حالة فوضى.(نستطبع حتى تبسيطه أكثر وذلك بالتخلص من جميع أشياء تشفير 
يونيكود الاختيارية).بالطيع كل شيء مايزال قيد التحويل إلى بايت في العمقءفتجمبع الذاکرة ۳ s۴۵‏ ryمص‏ مہ لا یعرف إلا ما يخص البایتات فقط_وJكj gStiream Writer‏ 
Reader‏ streamيأخذ‏ العبء (الواجب) عناء يعمل جمبع التحويلات المربكة عوضاً عنا. 


تتضمن معظم المعالجة التابعة لستريم ۳ه٠51الملفات.لذلك‏ دعنا نستخدم #۲ل2ةءR”هءtirكلمعالجة‏ ملف نصي.على الرغم من أننا قررنا سابقا في الفصل14 أن الملف اN‏ اهو 
شيء من الماضيءمن المحتمل أنه من الممتع كتابة روتين يستخرج قيمة من تراث ملف |N|.خذ‏ ملف يحتوي هذا النص: 
[SectionO]‏ 
Key1=abc‏ 
Key2=def‏ 
[Section1]‏ 
Key1=ghi‏ 
Key2=jkl‏ 
[Section2]‏ 
Key1=mno‏ 
Key2=pqr‏ 
والآن يوجد شيء لاتشاهده كل يوم»ولسبب مقنع!مايز ال بإمكاننا الحصول على قيمة من أجل 2رهفي مقطع ١1‏ 0اءه5(القيمة”از“ )إذا ما أردنا ذلك.سيكون علينا الرجوع 
بالكامل إلى استدعاء وہ|6etPrivateProfi!eS†rلواجهة‏ البرمجة التطبيقية ٣۴١‏ 4۸من الا يام التي تعود إلى ما قبل الدوت نت السيئة.أو نستطبع تنفيذ ۲علdةهR"‏ 4٠ء‏ في دالة 
مخصصة من قبلنا: 
Public Function GetINIValue (ByVal sectionName As String, ByVal keyName As String, ByVal iniFile As‏ 
SErImG) AS SEEING‏ 
Given a section and key name for an INI file,‏ > 
return the matching value entry.‏ ' 
Dim readINI As 10.StreamReader‏ 
Dim oneLlLine As String‏ 
Dim compare As String‏ 
Dim found As Boolean‏ 
On HErOon GOO BELO HaANILeT‏ 
Open the file.‏ ڪڪ 
If (My.Computer.FileSystem.FileExists(iniFile) = False) Then Return ""‏ 
readINI = New IO0.StreamReader (iniFile)‏ 
Look for the matching section.‏ حص ٣‏ 
found = False‏ 
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compare = "[" & Trim (UCase (sectionName)) & "]" 
Do While (readINI.EndOfStream = False) 

onelLine = readINI.ReadLine () 


If (Trim (UCase (oneLine)) = compare) Then 
د ا‎ Found the matching section. 
found = True 
ExT DO 
e ا‎ 
Loop 


Exit early if the section name was not found.‏ ڪج ا 
Tf (found = Fals€e) Then‏ 
readINI.Close()‏ 
SEAN‏ 
ENA UE‏ 
look for the matching key.‏ ل 
compare = Trim (UCase (keyName) )‏ 
Do While (readINI.EndOfStream = False)‏ 
If we reach another section, then the‏ ج ا 
U key Mas E ENeEe,‏ 
oneLlLine = Trim (readINI.ReadLine () )‏ 
If (Len (oneLine) = 0) Then Continue Do‏ 
NE (Ooneline.SUDSEEInG (O, U) — TI Then ExiE BO‏ 
Ignore lines without an "=" sign.‏ چ 
TE (Inser(onelLine, =") = Û) Then COnEInNUE DO‏ 
See if we found the key. By the way, I'm‏ کے کے کے کے 
SANS SUDSEETHOKN J inSEEad OE MeEEERN ) 9©‏ ' 
u E denli Mave EO MOEEY AOU CONEITEES AEN‏ 
Horm. Mert in Case Û QEOS ENIS EOUEIMeE DEO‏ ' 
a EOE Clase‏ 
ME (Tr im (UCase (One Line .SUOSSEEING (O, Insier (Oneline, €) >= I)J)) = compa Ee) Then‏ 
Found the matching key.‏ ا 
readINI.Close ()‏ 
Return Trim (Mid(oneLine, InStr (oneLine, "=") + 1))‏ 
ENS UE‏ 


E If we got this far, then the key was missing. 
readINI.Close() 
EE 
ErrorHandler: 
1 es Return an empty string on any error. 
On Error Resume Next 
If (readINI IsNot Nothing) Then readINI.Close () 
readINI = Nothing 
Return 
ENG EURCETOR 
ھعلملف من‎ c٣ ٣9و .أو عمل تخزين مؤقت مخفي‎ defauا‎ re۲٢ ۷2ا٥ هذا الروتین لیس استبدال ل وہ1ا†eS|ا؟etPrivateProت بالضبط فهو لايدعم قيمة راجعة افتراضية‎ 
أجل السرعة.تستطبع تحسين الروتين بمعالج خطأً أفضل.ولكنه يعمل على استخراج القيمة التي نبحث عنهاء ويعمل ذلك بقراءة الملف ال١اسطر سطر كل مرة من خلال قارئ‎ 


التجميع (الستر يم Stream Re2d6۲‏ (. 


MSSBOX (CEE INA Va NUe LSER, Keya, TFT CANI ESED) 


۲ 


ا 


يتضمن فضاء الاأسماء yعدة‏ ميزات لادارة الملفات في تفر عه ٣٥ر‏ S؟٥|!ذe۲.۴اuامصmهع.My‏ .ومن ضمنها ميزات تعمل على إنشاء ستريمات للقراءة والكتابة. 


جميع أعضاء الكائن ۳اءر؟!ذer.۴اuمcom My.‏ موجودة لاستيدال أو لإكمال ميزات إدارة ملفات موجودة سابقاً في الفيجوال بيسك.يجدول الجدول التالي بعض الميزات 
الطويلة الموجودة للتفاعل مع الملفات والادلة في الفيجوال بيسك.وما يكافئا في .My.Computer.File System‏ 


ChDir‏ تغيير الدليل"العامل"الحالي على المشفل(الدرايف) تعطي و تضع الخاصية FileSystem.CurrentDirectory‏ دليل"العمل"الحالي 
الافتراضي أو المخصص. بحيث يفهم من قبل التطبيق.إنك تضع الدليل الفعال من خلال نص المسار 
المجرد أو المناسب. 
CurDir‏ تحديد الدليل"العامل"الحالي والمشفل كنص مسار مرة أُخریءryە†eSystem.CurrentDirecا۴‏ هي البديل لميزة دليل الفيجوال 
ك|مJلstring full path‏ . بيسك.تعمل ١٥ء‏ على امتلاك مرونة أكير:فهي تتيح لك تحديد الدليل الحالي 


على مققل بطل المقفل العلىوها لحك عه رودا 


.FileSystem.CurrentDirectory 


FileCopy‏ صنع نسخة من ملف. يوفر ٥اأ۴رمه٤."هاءر5هاا۴‏ العديد من الميزات الإضافية القريبة من 
المستخدم خلفرمهع اا۴ . 


FileLen‏ استخلاص الطول باليايت لملف ما. الحصول على الكائن ۴٠٠٠١٤١‏ من خلال الطريقة 
۴ileSystem.GetFilelnfo‏ والوصول إلى خاصية ٢او‏ الذلك الكائن 


FileSystem.DeleteDirectory g FileSystem.DeleteFile ğرطJ|‎ Jدıتwت حذف ملف أو دليل فارغ.‎ Kill 
الاجر اءااا »وتوفر خيارات إضافية غير متاحة من خلال اانم.‎ 


یتم استبدال R٥2۳‏ بالطر ق FileSystem.RenameFile öjınaJ|‏ و 
FileSystem.RenameDirectory‏ . 


SetAttr‏ تعدیل مواصفات ملف ما باستخدام حقل بتل|ا٥ا؟‏ ٤اط‏ . نفس المعالجة المجدولة ل ٤4اه‏ المذكورة سابقاً في هذا الجدول.الخاصيات 
Attributesو !ReadOnly‏ لکائن ۴0"اا¡۴هي قر اءة/كتابة قیم.علی فرض 
أن لديك حقوق الأمن الضرورية لتغير مواصفاتءهانط )اج . 

لماذا تعمل ميكر وسوفت على تقديم العديد من ميزات ١y‏ والتي تضاعف ميزات فيجوال بيسك الموجودة؟ربما هي طريقة لجلب الاستقرار لممارسة البرمجة المعتمدة على ملف من 

خلال مقاربة أكير للتوجه الكائني. 


توفر الطرق My.Computer.FileSystem.OpenTextFile Reader‏ والمو زي Open extFileWriter‏ اختصارات لمشید معتمد علی اسم ملف من أجل الکائنات 
StreamWriterg StreamReader‏ .ıallارö:‏ 
Dim inputStream As IO0.StreamReader = My.Computer.FileSystem. OpenTextFileReader (fileNamePath)‏ 
مطابقة للعبارة التالية: 
Dim inputStream As New IO0.StreamReader (fileNamePath)‏ 
بالنسية ليءالعبارة الثانية هي الأفضل بسبب طبيعتها المصقولة.إذا أردت تحميل المحتوى الكامل لملف ما ضمن إما مصفوفة بايت أو مصفوفة نصية ليس هناك حاجة لفتح ستريم 
حالياً بما أن yيتضمن‏ الطريقة †× My. computer .۴ile Syste .۸R ٠20۸|٣٠‏ و الطريقة sه†ر0۸I|8هRe‏ ذات الصلة.هذه العبارة تفرغ المحتوى الكامل لملف ما في سلسلة 
فيه. 
Dim wholeFile As String = My.Computer.FileSystem.ReadAllText (fileNamePath)‏ 
تعمل كل من الطريقة My. computer .File System. Write ^| |7 ex‏ والطر بقة WriteA۱|8y tes‏ نفس الشيء»ءولکن باتجاه متعاكس.يوجد إلحاق لمعامل نسبي منطقي(بولين) والذي 
يتيج لك إما إلحاق أو استبدال محتوى جديد ذو صلة(مناسب) لأي محتوى موجود في ملف. 
إlZق=True‏ ' My.Computer.EFileSystem.WriteAllText (fileNamePath, dataToWrite, True)‏ 
ميزة دائماً مفقودة من الفيجوال بيسك وهي القدرة على عمل مسج مناسب على ملف محدد(محدد بالنهايات)(مثل المحدد الجدولي كعا"iامل-طهt‏ أو محدد بالفاصلة-2٣۳٣۳٥c0‏ 
imitedاde)أو‏ ملف حقل تابت الاتساع١|ءا؟-۸†فiس fxd‏ .واستخراج الحقول على كل سطر دون الحاجة إلى كود تفسير (ترجمة)إضافيعك0ء exra م2٣؟أ ٣9‏ . 
تتضمن الفيجوال بيسك الآن الكائن Microsoft. VisualBasic.۴ile|0. ext ۴e! ۴2s‏ الذي يبسط هذه المعالجة(العملية).وهذا الكائن يتيبح لك الإشارة إما إلى محدد الحقل(مثل 
رمز الجدولةطه) )أو مصفوفة سعات عمودءعzاء ٠١‏ داه . حالما تصحبه بمسار ملف.فإنه يقرأ كل سطر بيانات»يقسم الحقول المميزة لك ضمن مصفوفة نصية. 
تفتجح الطريقة My.c0mputer.۴ileSystem.Open TextField P arse‏ الملف وتعرف طريقة الترجمة في نفس الوقت. 
Dim sourceFile As FilelIO.TextFieldParser‏ 
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o _ Open the file with tab-delimited fields. 
sourceFile = My.Computer.FileSystem. OpenTextFieldParser (sourceFilePath, vbTab) 
ےکک ا‎ Process each line. 
Do While Not sourceFile.EndOfData 
dataFields = sourceFile.ReadFields () 


1 کے‎ dat aAE1eLGaS 1S aû SIMple SEEING QAEEAV, 
' so you can examine each field directly. 
If (dataFields (0) = "NEW") Then 


aM SO OMT‏ جص ل 
Loop‏ 
sourceFile.Close ()‏ 


یمکن للکائن ۵۴۸۲56۲|٥۲۴×٠٣أيضاً‏ أن يكتشف أسطر التعليق ويتجاهلها بشكل صامت. 


لدي بعض الأخبار السيئة والأخبار الجيدةالأخبار السيئة هي أن مشروع المكتبة لايعمل قراءة أو كتابة مباشرة للملفات القياسيةءوليس لديه حاجة لستريمات ملف.وهدا يعني أننا لن 
نعمل على إضافة أي كود إلى المشروع في هذا الفصل على الإطلاق.الأخبار الجيدة ستبقى لدينا أشياء مهمة للتحدث حولها.بالإضافة أننا تجاوزنا أكثر من نصف الكناب»فيمكنك 


أخذ راحة. 


متى حدث خطأً في تطبيق المكتبةءيعمل الروتين أولاً على إظهار رسالة الخطأً للمستخدمءومن تم يسجلها إلى أي "منصتات التسجيل۲5٥٠6اءا‏ وها ". 
Public Sub GeneralError (ByVal routineName As String, ByVal theError As System. Exception)‏ 
1 إعلام المستخدم بالخطاً 
On Error Resume Next‏ 
MSE OE EN N E O EN LEE EON ENE GC RL CE UC E CMC‏ 
EReRrr or Message, MSGEORSE VIE. OKO IY OE‏ 
MsgBoxStyle.Exclamation, ProgramTitle)‏ 
My .Application.Log.WriteException (theError)‏ 
ERA SUS‏ 
لذلك»من ينصت؟ إذا شفلت التطبيق ضمن الفيجوال أستوديوفإن الفيجوال بيسك تركب دائما منصت تسجيل يعمل على عرض النص في لوحة النافذة المباش رة 26م" "| 
المعرفة مسبقاءيمكن تمكينها جميعاً وتر كيبها من خلال ملف التطبيق و٣‏ ٥ء.م10‏ .إذا راجعت مشروع الفصل14 ستجد محتوى الملف و٣٥ء.م40والذي‏ يعمل على إعداد 
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العموميات (الشموlيlت).Generics‏ 
تستطبع الوصول إلى العموميات 5٤6۲٠و‏ .من خلال تقنية العموميات للدوت نت.العموميات:هي القدرة على استخدام "حافظات أمكنةء٣#ل|ههعهام‏ "لأنواع 
البيانات-أول ما ظهرت في الفيجوال بيسك 2005 وإطار عمل الدوت نت2.0 ذو الصلة.يقدمك هذا الفصل إلى "النوعياتكء|اامممء " على العموميات. 


في الدوت نت" العموميات "هي تقنية تتيح لك تعريف حافظات ك۲٠‏ ١اه‏ هع هام ‌أنواع بيانات ضمن أنواع أو طرق.لنقول أنك احتجت إلى تعريف فئة تتعقب بيانات 
زبون»ولكن لاتريد أن تنفذ تنسيق معين على قيمة "المعرف 0| "للزبون.يحتاج قسم من كودك التفاعل مع كائنات الزبون باستخدام قيمة معرف 0| انتفرءبينما سيستخدم 
جزء آخر من الكود مفتاح ترقيم حرفي(أبجدي) من أجل الزبون.ربما تتسآلءلما لا تعمل على تضمين فقط كلا من نوعي المعرف كحقول مميزة في سجل الزبون؟ إن هذا 
لن يعمل لأنني أحاول إيجاد حل لمال بسيط معقول نوعاً ما والاجابة عن ذلك السؤال ستحيرني.لذلك إليك النسخة العددية من الفئة: 
Class CustomerWithNumberID‏ 
Public ID As Integer‏ 
PubISE Hull IName AS SEIN‏ 
End Class‏ 
وهنا التنوع الذي يستخدم معرف ۱0 نصي. 
Cl aSS CUSEOMer Wi ERSEEING LD‏ 
Buble ID AS SEEING‏ 
Buble Hul IName AS SEIN‏ 
End Class‏ 
بالطبع تستطيع تعريف D|ككائن†ء#زط0.٠٠اءرS‏ .وتلصق >ءاءأي شيء تريده في ذلك الحقل.ولكن يتم اعتبار >#زط0.٠اءر؟"محدد‏ النوع بشكل ضعيف 
typed‏ yاweak‏ ". ولا يوجد شيء يوقفك من المزج بين قيم المعرف الاإنتغر ۲هو" اوالنصية و١٣‏ 5من أجل حالات مختلفة في مصفوفة لكائنات زبون. 
ما تحتاجه هو نظام يتيح لك تعريف الفثة بشكل عمومي.وتنأى بنفسك عن تعين نوع البيانات للمعرف 0احتى تنشئ بشكل عملي حالة من الفئة.أو تجمع كامل من حالات 
الفئة ذات الصلة.مع نظام مثل هذاءبإمكانك تعريف(تحديد)نسخة الأهداف العامة لفئة الزبون. 
Class CustomerWithSomelID‏ 
Public ID As <DatatypePlaceholder>‏ 
EBuola e EHULIName AS GEE ING‏ 
ae ClESS‏ 
فيما بعد عندما يحين الوقت لانشاء حالة :تستطيع إخبار اللغة بنوع البيانات الذي سيستخدم ل"حاجز المكان#۲لاه#عهام ". 
Dim oneCustomer As CustomerWithSomelD (replacing <DatatypePlaceholder> with Integer)‏ 
هذا ما تتيح لك الشموليات عمله.قواعد الفيجوال بيسك التي تعرف(تحدد) فئة الزبون الغير معينة(الغير مخصصة): 
Class CustomerWithSome ID (BEE)‏ 
EOE ID‏ 
Public Ful1Name As String‏ 
ENG Class ِ‏ 
حاجز المكان العام»٠‏ .يظهر في شرط 0الخاص.تماماً بعد اسم الفئة(ليس عليك تسمية حافظ المكان 7 ولكن أصيح تقليد عند تقديم كود بسيط يستخدم العموميات 
ener“‏ و.)کنوع بیانات.یمکن آن یتم استخدام1 في أي مكان ضمن تعريف الفئة حيث أنك لا تريد تحديد نوع البيانات مقدماً.الفئة وعضوهاص0اءهما الآن جاهزان 
للاستنساخ مع نوع بيانات بديل حقيقي من أجل7 .لانشاء حالة جديدة »جرب الكود: 
Dim numberCustomer As CustomerWithSome ID (BE HREEGEE)‏ 


عندما يتم إرفاق (#۲وه١٠‏ 0۴)إلى نهاية تعريف فئة.تتصرف الفيجوال بيسك وكأنك صرحت عملياً عن متغير لفئة لديها عضو انتغر مسمى 0|.في الحقيقةءإنك تفعل.عندما 
تعمل على إنشاء حالة من فئة عمومية»يعرف المترجم فئة منفصلة تبدو فئة غير عمومية مع تبديل جميع حاجزات الاأمكنة. 
Dim customerl As New CustomerWithSomeID (Of Integer)‏ 
Dim customer2 As New CustomerWithSomeID (Of Integer)‏ 
Dim customer3 As New CustomerWithSomeID (Of String)‏ 
تعرف هذه |لاسطر llتjı‏ مInteger)j| CustomerWithSomelID(Of String)je all>. CustomerWithSome!D(Of‏ . customer1و‏ acustomer2ي‏ حالات 
حقيقية من نفس نوع البیانات»ولکن ۲۲3 ۳٥1ءن‌هو‏ حالة لنوع بیانات مختلف تماماً. الإسنادات بین ٣۴۲1‏ 0اءاعو ٣٠۲2‏ 0اءامستعمل»ولكن لا تستطيع مزج أياً منهما 
مع custome۲3دون‏ عمل تحویل صریح. 
"هذا سيعمل بشكل جيد 
customerl = customer2‏ 
1 هذا لن يعمل 
customer3 = customerl‏ 
كحقيقةء أنواع بيانات وقت التر جمة المولدة بشكل آلي بواسطة المترجم» تعرض جمبع ذاتيات الفثات الغير عمومية.حتى المساعد الفوري ٥5٠ه5||١6”|بالمعنى‏ الضيق 
للكلمة يكتشف نوع البيانات البديل.يتضمن الشكل التالي تلميح أداة ما امم .تماما على يمين قائمة اختيار عضو الحالةءوالتي تعرف بالضيط العضو ۵۲1.|0٣0اوuع‏ 
کإنتغر 6۲و ہا . 


لفصل السادس عشر :الشموليات. Mhm76‏ 


Dim customerl1l As New Customer Uit h3Some ID (OF Integer] 
Dim Customer AS Nev TUSTOMEEVWiIThSoOMmME ILD (OE Integer] 
Dim customer3 AS Nerv Customer UithSome ID {OF String] 


CUSTOMEE 1 -| 
a Equals 
@  FullM arma 
Hl GetHashCode 
i GetT ype 
ټ‎ Public IG As Integer 
= ReferenceE quals 
HA ToString 


Common ااك‎ 


ضمن تعريف الفئةيمكن لحاجز المكان ۲ آن يظهر في أي مكان»حتى ضمن قوائم معاملات نسبية ٣8١‏ ۷و٣2وتصريحات‏ متغيرات محلية. 
Class SomeClass (BET)‏ 
BUbIiIG EUNCEION LEFANSEOEMDAEA(BYVal SOuUrCeDalta AS TIT) AS 1‏ 
اف كرهة رل اال رمات ما 
Dim workData As‏ 


EDE EUREE OM 
End Class 
تعمل العموميات مع التر اكيب والواجهات أيضا.‎ 
SEEUE EUEE SOME SEE UCEUEEKOE TT) 
Public GenericMember As T 
End SEEUCEUZe 
Interface ISomelInterface (Of T) 
Sub DoWorkWithData (ByVal theData As T) 


End Interface 


إذا كان هناك أقل حاجة لحاجز مكان نوع بيانات حكومة اتحادية؛١٠”٠٣‏ ٠۲٠0۷و‏ ا۲2٠١‏ .فإن تنفيذ العموميات الموصوف تماما سيستقبلها بشكل خاص.ونوعها متقن 
لتأجيل تعريف نوع البيانات حتى أخر «قبقة.ولكن عموميات الدوت نت لا تتوقف «ناك. 


حاجزات الأمكنة العمومية-وتعرف أيضاً كوسيطات نوع 6/۶ع”/2/4م عم -فكل فنة عمومية يمكن أن تتضمن حاجزات أمكنة متعددة بإضافتهم إلى شرط 0۴ 
الأولي. 
Class MuLEITYBPEeS(OE RI, T2)‏ 

Public Memberl As T1 

BUBE Member AS M2 

End Class 
كما ذكرت من قبل.ليس عليك استخدام الأسماء المملة 11و۳2 | .مهما تكن الأسماء التي تختارهاءضمنها كقائمة مفصولة بفاصلة تماماً بعد الكلمة المحجوزة 0۴.عندما تكون‎ 
.12 محل‎ S۲19 جاهز لاإنشاء حالة »كرر القائمة المحددة بفاصلة في نفس الترتيب»ولكن استخدم نوع حقيقي.في هذه العبار ةيحل انتغر #۲و#١امحل 11ونص‎ 

Dim uselnstance As MultiTypes (Of Integer, String) 


نوع الوسيطات التي تضمنها في عمومي ماءمثل ۲ءيقبل أي نوع بيانات صحيح(محقق)ومن ضمنها الانتفرء السترينع(السلة الحرفية)ءنماذج ويندوز 
.System.Windows.Forms.Form‏ أو أنواع خاصة بك. یمکن أن یتم استبدال ۲ باي شيء تشتقه من ٤٥ز‏ 0.٣٣٥ءرS.والذي‏ هو کل شيءءتستطبع حتی تصور 
العبارة. 

CIlaSS SOomeCclaSS (OE ® 


يمکن تبديلها بما يلي: 

Class SomeClass (Of T AS System Object) 
إضافة الشرط ءه4لجعلها تبدو مثل تصريحات الفيجوال بيسك الأخرى.حسناًءتستطبع التوقف عن التخيل وتبدأً العمل:تدعم حاجزات الأمكنة الشرط 45 .لو لم تضمن الشرط‎ 
تعتبر الفيجوال بيسك أنك تعنياء6زط0. 51ر8 .ولكن بإمكانك إتباع ۸5 بأي نوع ترید:‎ , 


Class FormOnlyClass (Of T As System.Windows. Forms. Form) 


End Class 


بإضافة فئة معينة مع الشرطكة .فإنك تطبق قيد ٤٣/4٣1ئ07ء‏ على النوع العموميءحد ١0اه"‏ أايجب أن يتم مطابقته لاستخدام النوع.في هذه الحالة. يقول القيد:"يمكن 
آن توفر أي قيمة ل7 طالما أنه أو مشتق من ۴0۲7 . ۴0×5 . ten. Nin dows‏ Sys."وهذا‏ يعني أنك تستطيع إنشاء حالة من ھا٤‏ را٣ ۴٥۲٣0‏ باستخدام واحد من 
نماذج تطبيقكولكن ليس باستخدام فثات غير الفورم. 
ا 
DEM USENGSEOEM AS HOFIRON IVE la SS KOE Horm)‏ 


۳ ا ا د 


الفصل السادس عشر:الشموليات. Mhm76‏ 
Dim usingForm As FormOnlyClass (Of Integer)‏ 
عندما تضيف قيد لوسيط نوع.فإنه يؤثر في الميزات التي بإمكانك استخدامها مع وسيط النوع.خذ هذه الفثة العمومية المقرر لها العمل مع النماذج»ولكن غير مصرح عنها 
بتاك الطريقة: 
Class WorkWithForms (Of T)‏ 
Public Sub ChangeCcaption (ByVal whiıcenEOorm AS WW, ByVal newcapEion AS SEEING)‏ 
السطر التالي لن يتم ترجمته 
whichForm. Text = newCaption‏ 
End Sû‏ 
nol CEES,‏ 
في هذه الفئة »سيفشل الاسناد إلى whic۸ ۴٥۲٣.7 6×٤‏ لن الفئة WorkWith ۴٥۲s‏ لاتعرف انك تخطط لاستخدامها مع النماذج.فما تعلمه أنك تخطط لاستخدام 1»و 
1ء بشكل افتر اضيي من نوع ا۲ 6زط ۵٠.0‏ ء/رS.ولا‏ توجد خاصية نص ×۴٠۲في‏ الفئة†ecز0b. Syste”‏ . 
إذا غيرت تعريف الفئة W 1۸۴٥۲۳۶‏ ۸اه لن تقبل الكائنات ۲۳٠۴.فإن‏ وجهة نظر ترجمة هذا الكود تتفير بشكل مثير. 
Class WorkWithForms (Of T As Windows.Forms.Form)‏ 
Publ1e Sub ChangeCaptai on (BYVal wHIGREOGEM AS TU, Bvval newCagt10n AS SEIN)‏ 
1 سيترجم الآن. 
whichForm. Text = newCaption‏ 
End SUB‏ 
End Class‏ 
بما أن ۲ عليه أن يكون من نوع ۴٠۲١‏ أو شيء مشتق من نموذج.فإن الفيجوال بيسك تعرف جميع أعضاء فئة الفورم»ومن ضمنها النصأ×٠٠‏ .فهو الان متاح لجميع 
أشياء ۲.ويالتالي يعمل الاإسناد ئxھwhichForm.7.‏ 
بالإضافة إلى الفنات.تستطيع أيضاً استخدام الواجهات 5ه٥ه6۲۴ا”لتقيد‏ أنواعك العمومية. 
Class ThrowAwayClass (Of T As IDisposable)‏ 
فالحالات من ك5ءھا٤‏ رهس W۸١طآيمكن‏ أن يتم إنشاءها عند الحاجة.ولكن إذا تم تز ويد النوع فقط مع التصريح الذي ينغفذ الواجهة ماهءهمءاص|. 
GS SET OO E E N‏ 
'"TDisposable‏ 
Dim disposablePen As ThrowAwayClass (Of System. Drawing. Pen)‏ 
1 ل ل ااا ان کے ات اا ی کک که 
"IDisposable‏ 
Dim disposableNumber As ThrowAwayClass (Of Integer)‏ 
ولكن تستطبع أيضاً إتباع الشرط على حافظة العمومي بالكلمة المحجوزة ١6W‏ 
Class SomeClass (Of T As New)‏ 
End Class‏ 
يقول الشرط س٠"‏ ۸ لنوع العمومي."اقبل أي نوع ل ١ء‏ ولكن فقط إذا تضمن دلك النوع مشيد لا يتطلب معاملات نسبية."وبالتالي على ۲ أن يتضمن مشيد 
اقتراضيي.حالما يتم تعريغه»ستكون قادر على إنشاء حالات جديدة من ۲ ومهما يكن النوع فإنه يحدث لأن يكون في نوعك العمومي. 
Class SomeClass (Of T As New)‏ 
BPUBDISE SUD SOMeSUD ()‏ 
Dim someVariable As New T‏ 
End SUS‏ 
End Class‏ 


إذا تضمنت فئتك العمومية وسيطات لانواع متعددة»فكل وسيط يمكن أن يتضمن الشرط ك4الخاص به مع النوع المميز أو تقيد الوlجqةconstrait interface‏ . 


أحياناً تكون بحاجة إلى أداة متعددة الوظائف. كما رأيت في كل حافظة عمومية.إذا كنت بحاجة إلى حافظة واحدة لتضمين قيد لفئة معينة55ه|اء »واجهة6٥16۲۴8|‏ و" جديد 

New‏ " كلها مچ بعضها البعض(أو فجأةً)تستطبع فعل هذا.اعمل على تضمين بعد الكلمة المحجوزة ك4عدة قيود في أقواس مجعدة: 

Class SomeClass (Of T As {Windows.Forms.Form, IDisposable, New}) 
End Clases 


قيد واجهة واحد في نفس الوقت. 
Class SomeClass (Of T As {Runtime.Serialization.ISerializable, IDisposable})‏ 
ENA CIES‏ 


والآن مايزال بإمكانك تضمين تقيد فئة ككهاعوتقيد"جديد "٠W‏ ".حتى مع هذه الواجهات المتعددة.(نستطيع تضمين أكثر من تقيد فئة واحدة من أجل حافظة مفردة).لو 
تضمن نوعك العمومي وسيطات أنواع متعددةء#۲اهم”۳ همم ممرا مامtiاuص‏ .كل منها يمكن أن يكون لديه مجموعة القيود المتعددة الخاصة به. 


يمكن لأنواع العمومي أن تتضمن أنواع متداخلة خاصة بها. 
Class Bevel NOE‏ 
Buble LeveliIMember AS Ul‏ 
Class Level2 (Of T2)‏ 
Public Level2Memberl As T1‏ 
Public Level2Member2 As T2‏ 
el CUES‏ 
End Clas5‏ 


فيمكنك مداخلة العموميات بالعمق الذي تريد . 


رں 


الفصل السادس عشر:الشموليات. Mhm76‏ 


إذا بدت الأنواع العمومية مخيفة أو ساحقة قليلا.لا تفتاظ .فليس عليك إنشاء نوع عمومي بالكامل لاستخدام ميزات العمومي الجديدة.تستطيع إضافة دعم عمومي لطريقة 
وحيدة فقط ضمن فئة عادية مختلفة. 
Class SomeClass‏ 
NN GSE N CRE E OEE EEA ST ERS ESN RE EOS EE‏ 
PuBl1G Shared SUB ReverseValues (Of T) (ByRef first As RSL SSCA AS‏ 
هذه الطريقة هي E‏ ا شمولية مع شرطها الخاص ا 
اعكس محتويات كل من المتغيرين 
Dam Ro LIES AS‏ 
ROLIHEESE > EIESE‏ 
first = second‏ 
second = holdFirst‏ 
End Sub‏ 
ERS ClaSS‏ 
إن طرق العمومي 66۸6۲1٤١‏ مفيدة عندما تحتاج متغير محلي من نوع الحافظة ٣٥ل١اه‏ هام ضمن طريقة(کما عملنا مع ۴۲۶۲ ١اه‏ هنا).ولكن لا تعرف النوع 
مقدماً.استخدام هذه الطربقة sمںاة‏ ۵۷ء8۷۵۲ المتشاركة ۵4١٥۸2۲٣ءيعمل‏ مثل الطرق الاخری»ءمع شرط الز ائد .©f۴‏ 
Dim x As Integer = 5‏ 
Dim y As Integer = 10‏ 
SomeClass. E Integer) (x, Yy)‏ 


10 رض‎ 
MsgBox (x) 


إذا كنت ستستخدم الحافظة لواحد أو أكثر من معاملات طريقة.ستعمل الفيجوال بيسك على استتتاج النوع بالاعتماد على القيمة الممررة.إذا كان بإمكان الفيجوال بيسك 
تخمين النوع في هذه الطريقة.فلا تحتاج حتى إلى الشرط 0۴عند استدعاء طريقة العمومية. 


كما مع أنواع العمومي»تسمح لك طرق العمومي إضافة قيود إلى الحافظات. 


SomeClass.ReverseValues (x, Y) 


ذكرت سابقاً كيف يعمل المترجم على إنشاء فثات مستقلة بشكل أساسي لكل تنوع حالة لفئة عمومية قمت بإنشانها.وهذا يعني أن كل من هاتين الحالتين تستخدمان بالفعل 
ويشكل عام فئات مستقلة ومختلفة بالكامل: 
Dim numberVersion As SomeClass (Of Integer)‏ 
Dim textVersion As SomeClass (Of String)‏ 
حیث أن کل من (erوھtہ!‏ ass)O۴ا8omeCو String)‏ 80meCss)0۴فنتین‏ مختلفتین بالکامل»حتی ولو كان لديهما نفس الاسم القاعدي.بطريقة ماءتعمل الفيجوال 
بيسك على إعادة تعريف اسم الفثة من أجلكبحيث تتيح لك استخدامها بطريقتين مختلفتين أو أكثر. 
تيح لك العموميات أيضاً تضمين اسم معطى(أو ثابت) في لعبة إعادة تعريف فئة.عادةتستطبع إنشاء فقط فئة وحيدة مع اسم تابت ضمن فضاء أسماء خاص»ولكن مع 
العموميات.تستطبع إعادة استخدام اسم فئةطالما أن استخدام الحافظات بين الفئات مختلف تماماًءإما في عددها أو في قيودها المطيقة. 
CIaSS SomeclasSs (Of TI)‏ 
هذه فئة عمومية مع حافظة وحيدة 
ERI Clases‏ 
Class SOoMeCLaASS (OE TE T2)‏ 
هذه فة عمومنة خنلفة دالكامل مع حافطنن. 
O CESS‏ 


۲ 


ستعمل الفيجوال بيسك على تقرير أي نسخة من الفنتين ستستخدم بالاعتماد على الشرط 0۴ الذي عملت على تضمينه مع تصربح الحالة. 
Dim simpleVersion As SomeClass (Of Integer)‏ 
Dim complexVersion As SomeClass (Of Integer, String)‏ 


في الحقيقة تشع العموميات في منطقة التجمعات.الإصدار الأول من الدوت نت لديه من بين الآلاف من الفئات الممكنة المفيدةمجموعة من فنات" التجمع ١0نا‏ ااه 
"»جميعها في فضاء الأسماءء٠هناءهااه٥.‏ ”ارك .يتيج لك كل تجمع حشو أي حالات لكائنات أخرى كما تريد داخل ذلك التجمعءواستخراجها فيما بعد.تختلف التجمعات 
في كيفية الحشو والاستخراج.ولكنها جميعاً تتبح لك إلصاق أي نوع من الكائنات في التجمع. 
واحدة من فثات التجمع هي الفئة )ء0s.S†2اcمااSystem.Co.تتيجح‏ لك المكدسات ء)ءهSتخزين‏ كائنات بشكل منضد:الكائن الأول الذي تعمل على إضافته إلى 
المكدس يذهب إلى الأسفل وكل واحد تعمل على إضافته يذهب إلى أعلى الكائن السابق له.وعندما تعمل على إزالة بند ماءفإنه يزول من الأعلى.(هذا نظام"ما يدخل 
أخيرآءيخرج أولاً ااه ك۲ in,‏ اا "وفي بعض الأحيان يدعى " 1|۴١‏ ") تدير الطريقة ۸ء۴ والطريقة م٠۴‏ إضافة وإزالة الكائنات. 
Dim numberStack As New Collections.Stack‏ 
numberStack. Push (10)‏ 
umber SE alek . EUSR (20)‏ 
numberStack. Push (30)‏ 
MsgBox (numberStack. Pop ()) ' Displays 30‏ 
MsgBox (numberSstack .BOD()) ! Displays 20‏ 
MsgBox (numberStack.Pop()) ' Displays 10‏ 


توجد أيضاً الطريقة ۸٠٠والتي‏ تعتبر البند الأعلىءولكنها لاتزيله من المكدس.الأمر مع المكدسات(والتجمعات المشابهة الأخرى)هو أنه ليس عليك وضع فقط نوع واحد 
من الكائنات ضمن المكدس.تستطبع مزج جمبع أنواع الكائنات التي تريدها. 


القصل السادسن غتز القمر ابات Mhm76‏ 
Dim numberStack As New Collections.Stack‏ 
numberStack. Push (10) ' Integer‏ 
mMuUMDer SE alek. EUS (AT mM sneakiınog im.) TT SEEING‏ 
nUMDEer SE ack. EUS (Me  BUEEORL) TT CONEEOL‏ 
لاييالي المكدس»بما أنه يعامل كل شيء ك †ء#زط0.٠1ءر8.ولكن‏ ما الذي يحدث إذا ما احتجت لضمان أن يتم وضع انتغر ۶/#وع7۲/فقط ضمن مكدس؟ ما الذي يحدث 
إذا ما أردت تحديد(أو تخصيص)مكدس ما إلى نوع بيانات معين»ولكن لا تريد كتابة فنات مكدس منفصلة(أو مستقلة)لكل نوع ممكن؟ 
من المؤكد أن هذا بيدو لي كعمل العموميات بالنسبة لي.من الواضج أنها طريقة ميكر وسوفت أيضاًءلذلك. عملت على إضافة تفرع لتجمعات عمومية جديدة إلى إطار 
العمل.وهي تظهر في فضاء اا سماءء System. Coااecاio s.6٠6۲‏ .توجد عدة فئات مختلفة في فضاء ال سماء هذا.متضمنا فئات للقوائم المرتبطة ١٥٣ا‏ 
stsاا.‏ الطوابیر مهنو .والقواميس5 0۸28ا¡ .توجد فئة تدعی(۲ 0۸)0۴ 5)8 .وهي ما نرید تماماً. 
Dim numberStack As New Collections.Generic.Stack (Of Integer)‏ 
numberStack. Push (10)‏ 
DuUMbDer SEaek . EuUSh (20)‏ 
numberStack. Push (30)‏ 
والآن إذا حاولنا إضافة أي شيء غير الانتغر إلى )ءة#۲5طن٠»سيحدث‏ خطأ فالكود التالي لن يعمل: 
DUMOEE SEaAEKE. EUS EY again.)‏ 


بالعودة إلى الفصل 6ءفقد قدمت الأنواع" القابلة بدون قيمة #اطهاا" ".وهي طريقة السماح لان يتم استخدام"لاشيء و١٣†ه.‏ " مع الأنواع ذات القيمةئ٥‏ مرا ue‏ اva‏ . 
Dim numperOrNothing As Integer?‏ 


على الرغم من أنك لاتستطبع الحكم من سطر الكود المصدري هذاءفالأنواع بدون قيمة #اطهاانا٠يتم‏ تنفيذها بالفعل باستخدام العموميات. نسخة التصربح الكاملة 
:ganumberOrNothing’s J‏ 
Dim numberOrNothing As Nullable (Of Integer)‏ 


تعمل الفيجوال بيسك على توفير وبكل بساطة اختصار لهذه القاعدة من خلال اللاحقة? .تستطبع استخدام أا من التركيبين للتصربح عن الحالات القابلة لان تکون بدون 
قيمة nullable‏ . 


عندما يستخرج زبون كتاب أو بند مكتية آخرءيتم حساب تاربخ استحقاق الدفع بشكل آلي بالاعتماد على عدد الأيام المخزنة في حقل قاعدة البيانات 
eMediaype.checkoutDaysههc.‏ ولكن ما الذي يحدث لو كان التاريخ المحسوب يوم عطلةءوالمكتبة مغلقة؟يمكن أن لا يكون الزبون قادر على إعادة الكتاب حتى 
اليوم التالي»مما يسبب غرامة.وهذه الغرامةحتى لو كانت صغيرةء يمكن أن تبداً سلسلة ردود أفعال في حياة الزبون .لحسن الحظ يمكن تجنب هذا بإضافة قائمة العطل إلى 
المشروع.فإذا وقع يوم إعادة البند على عطلة مونقة.فإن البرنامج يضبط التاربخ للأمام حتى يجد تاربخ غير العطلة. 


بقدر صغفر التطبيق القائمة بذاته والذي يدير بياناته بالكاملءفليس هناك حاجة ملحة للعموميات في تطبيق المكتبة.مهما يكنءتوفر الشموليات فوائد أكثر من تقيد أنواع 
البيانات المخزنة في فة أو تجمع.فهي تحسن أيضاً دعم المساعد الفوري وتحويل البيانات.الذي يمكن للفيجوال بيسك الاإخبار به مياشرةءعلى سبيل المثالما هو نوع 
البيانات الذي سيظهر في تجمع.سنعمل على تخزين العطل المدارة بواسطة مشروع المكتبة في جدول رهلاه لقاعدة البيانات.محتويات هذا الجدول نادراً ما 
تتغيرسنخزن البيانات داخل التطبيق.ولتبسيط إدارة تلك البيانات المخزنةسنعمل على تخزين العطل في تجمع شمولي(عمومي). 
أولاً دعنا نعمل على إنشاء فئة تحفظ مدخلة عطلة مفردة.أضف فئة جديدة إلى المشروع من خلال قائمة مشروع †ءهزه٣۴‏ > >إضافة فئةsءها٤ ۸۵٩4‏ ءوامنحها الاسم 
Se.‏ ayلiاH0.‏ يظهر التركيب المعروف للفئة الفارغة. 
BPuUBlIG Class HOLlIdaAYSEeE‏ 
ERG Class‏ 
يتضمن جدول قاعدة البیانات حقلین رئیسبین يتم استخدامهما لحساب العطل: ممر۲ر۲) ٣٤و‏ اأم0رEnr.دعنا‏ نخزنهما كعضوين للفئة »ونضيف إشارة تكفل أن تكون 
لمدخلة صحيحة. 
Briveate HOlI1dayIype AS SEEING‏ 
Private HolidayDetail As String‏ 
Private IsValid As Boolean‏ 
سنعمل على ملئ هذه الحقول الخاصة من خلال مشيد الفئة. 
Public Sub New (ByVal entryType As String, ByVal entryDetail As String)‏ 
1 ااتشاء ماحخلة حه مدخلة عطلةه دة 
HolidayType = Left (Trim (UCase (entryType)), 1)‏ 
HolidayDetail = entryDetail‏ 
1 ال ا ا کا ا دان و 
IsValid = True‏ 
Select Case HolidayType‏ 
Case "A"‏ 
ل ان وک وا 
'mm/dd‏ 
IsValid = IsDate (entryDetail & "/2004")‏ 
Case "E"‏ 
١‏ التفاصيل رقم من 1 إلى7 
If (Val (entryDetail) < 1) Or (Val (entryDetail) > 7) Then IsValid = False‏ 
Case OY‏ 
1 ق ا ا کک 
IsValid = IsDate (entryDetail)‏ 
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Case Else‏ 
الغير صحيح هب ان ل ا 
IsValid = False‏ 
End Select‏ 
BENA SUS‏ 
من الواضح»أن مدخلات العطل لديها نظام تشفير خاص بهاءولن يكون من العدل إجبار الكود في مكان آخر من التطبيق لان يتعامل مع جمبع تعقيدات مقارنات تاريخ 
العطل.لذلك.دعنا نضيف طريقة عامة إلى الفئة تشير فيما إذا كان تاريخ معطى يتوافق مع عطلة مخزنة في حالة. 
Public Function IsHoliday (ByVal whatDate As Date) As Boolean‏ 
سام مار ا کر ل مان کر اا اه ن ن اا 
Dim buildDate As String‏ 
کا فا اا در م عا اوا کن کا ا کو ا ع 
If (IsValid = False) Then Return False‏ 
Select Case HolidayType‏ 
Case "A"‏ 
سنوي ' 
buildDate = HolidayDetail & "/" & Year (whatDate)‏ 
If (IsDate (buildDate) ) Then‏ 
Return CBool (CDate (buildDate) = whatDate)‏ 
Else‏ 
eg, EN CNS YN AS EER E ACS‏ 
non-leap-year.‏ ' 
Return False‏ 
ROL |‏ 
Case E"‏ 


يوم من اسبوع 


Return CBool (Val (HolidayDetail) = Weekday (whatDate, FirstDayOfWeek.Sunday) )‏ 
Case OF‏ 
1 ری فت اا کات حه ما هه رة دا E‏ 
Return CBool (CDate (HolidayDetail) = whatDate)‏ 
End Se leg‏ 
ERC EURE EOD‏ 
لقد انتهينا من هذه الفئة.والآن ما نحتاج إليه فقط مكان لحفظ سجلات العطل المخزنة.يتضمن فضاء الأسماء ءأم"مions.6اecااm.CoهstرS‏ عدة فثات تجمع مختلفة 
نستطيع استخدامها.بما أن الشيء الوحيد الذي نحتاج إلى عمله مع العطل حالما تكون في التجمع هو عمل مسح عليهاء البحث عن التطابقاتءإن الفنة(۲ 1)0۴ءأا القياسية 
تبدو الأفضلءوميزاتها الرئيسية طبقاً لتوتيق الدوت نتءتتيح لك الوصول إلى الأعضاء من خلال الفهرس×6١١|‏ . 
افتح ملف ۷6 .ا6۲2٣٠6واعمل‏ على إيجاد أين تظهر المتغيرات العامة.في مكان ما قريبة من أعلى الفئة.ومن ثم أضف تعريف من أجل تجمع عام سيعمل على تخزين 
جميع العطل. 
Public AllHolidays As Collections.Generic.List (Of Library.HolidaySet)‏ 
هذا تجمع شمولي. 
اعمل على إيجاد الطريقة ٠٠‏ اءر8ءzاه‏ ز١٠‏ »مان زال في الملفط۷ 667٥/2/.‏ .أضف الكود التالي والذي سيمهد لتخزين العطل العامة. 
AllHolidays = New Collections.Generic.List (Of HolidaySet)‏ 
هذه هي البنية التحتية.لنعمل على إضافة روتينات تتمكن من الوصول إلى قائمة الشمولي هذه.نحتاج إلى روتين سيخبرنا»صواب أو خطاءفيما إذا تاريخ معطى(تاريخ 
استحقاق الدفع المخطط له بالنسية ليند المكتبة)يتطابق مع من العطل أو لا.أضف الدالة مه0 رهلناه١ءاإلى‏ الملف .Genera/. vb.‏ 
Public Function IsHolidayDate (ByVal whatDate As Date) As Boolean‏ 
الكرى مك االشا ورتم اال دا ٠‏ 
Dim oneHoliday As Library.HolidaySet‏ 
اا ااه ا ا ن کا ا ت 
EOE Hae GOneHoOlN day EN ALULHSLIA VS‏ 
If (oneHoliday.IsHoliday (whatDate) ) Then Return True‏ 
Next oneHoliday‏ 
ليس عطلة ' 
Return False‏ 
BERG EUNEEON‏ 
يبين هذا الروتين 6ة2رههاه١ء!‏ كيف تأتي العموميات مناسبة للاستخدام.فكل السحر يحدث في العيارة 1٥ع‏ ۲٠۴.في‏ تجمع عاديءلن نكون واتقين من نوع البند الذي 
تم تخزينه في التجمع.فيمكن أن تكون 86/ههناه1اأو سترينغ و١‏ ء8 أو انتغر#۲و٠٤١|‏ .نحن سنعلم بما أننا المطورين»ولكن الفيجوال بيسك تعبث من غير بصيرة في هذه 
المنطقة »و تفترض انك مزجت أنواع بيانات في تجمع واحد.ولكن لننا ربطنا التجمع ءرههİاه١۳١١۸Aإلى‏ الفئة jli.Of HolidaySet طرشلl مادختسابH 0i2‏ 
الفيجوال بيسك تفهم الان أننا سنعمل على تخزين فقط بنود S6؟/ههااه1في‏ التجمعءرهةهااه ۸|١۳١‏ .وذلك يعني أنه ليس علينا بشكل صريح تحويل البنود المستخرجة من 
التجمع إلى نوع بيانات ٤56ره‏ هاه ١.إذا‏ لم نستخدم فئة العموميءسبيدو الكود نوعاً ما مشابه لهذا: 
Dim scanHoliday As System.Object‏ 
Dim oneHoliday As LIBRARY.HolidaySet‏ 
Fo Hach SEanHola day IM AL LEO TIAAYS‏ 
oneHoliday = CType (scanHoliday, LIBRARY .HolidaySet)‏ 
If (oneHoliday.IsHoliday (whatDate) ) Then Return True‏ 
Next‏ 
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و٥ بما أن التجمع العادي يعمل على تلخيص كل شيء إلى †ء#زطا0.١٠#اءرS»فسيكون علينا بشكل صربح تحويل كل كائن تجمع إلى مهاه باستخدام الدالة ممر‎ 
دوال التحويل المشابهة.ولكن مع تجمع العموميءتأخذ الفيجوال بيسك العبء عنا. سنبقى بحاجة إلى تخزين العطل من قاعدة البيانات.لذلك أضف الطريقة‎ 
والتي تقوم بهذا العمل.‎ Genera/.vbىلإ‎ RefreshHolidays 
BUBBLE Sub RefreSRHOLIAAYS (0) 
e LE KE Sa 
Dim sqlText As String 
Dim dbInfo As SqlClient.SqlDataReader 
Dim newHoliday As Library.HolidaySet 
On ErrEO: GOL ELTOTHARNGALOE 
ا ا ا ا ق اا :د‎ 
AllHolidays.Clear () 
ى اة ا ت‎ 0 E 
SGLLExRE SELECT €1 EROM HOlTGAVE 
dbInfo = CreateReader (sqlText) 
Do While dbInfo. Read 
newHoliday = New Library.HolidaySet (CStr (dbInfo!EntryType), CStr (dbInfo!EntryDetail) ) 
AllHolidays. Add (newHoliday) 
Loop 
dbInfo.Close () 
Return 
ErrorHandler: 
GeneralError ("RefreshHolidays", Err.GetException () ) 
On Error Resume Next 
EE NOE (OBInNEO US Noening) Then GADINEO CLOSE) ° OBINEO  NOEDMING 
Return 
ERA SUS 


لقد رأيت الكثير من الكود مشابه لهذا سابقاًء الكود الذي يعمل على تحميل سجلات من جدول قاعدة البيانات ضمن البرنامج. 
يوجد مكانين حيث نحتاجهما لاستدعاء الطريقةءرههناه١5۸۳ء٠۲؟ه8‏ :عندما بيدأ البر نامج للمرة الأولىءوفيما بعد حيثما تحدث تغير ات إلى قائمة العطل.لن نقلق فيما يخص 
التفيرات على القائمة من قبل المستخدمين الآخرين»سنركز فقط على متى يعمل التطبيق المحلي على تحديث القائمة.أولا.افتح الملف ٥۸E ve٤5. ۷b‏ /اca//اممA.أضف‏ 
الكود التالي إلى ملچ حدjث LoadDatabaseSettings( )J جgمll sleaiwll ae. MyApplication_Startup‏ . 

RefreshHolidays ()‏ 
كما ترى تماما في هذا الروتينءلقد أضفنا سابقاً المحرر الذي يدير قائمة العطل.الشيء الوحيد الباقي عمله هو الوصول الحقيقي إلى قائمة العطل عند استخراج 
البنود.وسنعمل هذا في الفصول اللاحقة إن شاء اللّه. 


الفصل السابع عشر:الاستعلام المتكامل للغة ١اا Mhm76‏ 


الاستعلام المتكامل للغة 1NQا‏ 
لقد تعززت فيجوال بيسك الآن بلينكو.ميزة جديدة في الفيجوال بيسك2008 تتبح لك الاستعلام عن مصادر البيانات المنفصلة باستخدام قواعد عامة. 


لينكوNQ‏ 11 .اختصار ل: الاستعلام المتكامل للغة aed Query‏ وء !n†‏ eوuaوnهL‏ »وهي ليست مجرد تقنية واحدة .ولكن تقريياً حوالي مليون تقنية دوت نت جديدة للفيجوال 
بيسك وجميعها تعمل بشكل تر ادفي(بالتتالي) لجعل حياتك البرمجية أسهل.ليس أسهل في كل حالة.وكما مع أية تقنية تظهر للمرة الأولىءتوجد محاسن ومساوئ. 


تتواجد لينكو لأن بعض المبرمجين المصابين بالضجر لدى ميكروسوفت كانوا يحاولون الوصول للبيانات في قواعد بياناتهم بشكل مختلف عن ما يفعلوه بالملفات المعتمدة على 
البيانات هاه ك#ءهذ-هاا .أو بياناتهم الكائنة في الذاكرة.أو بيانات ا ×.مع لينكو ءتتيج لك قاعدة مفردة الوصول إلى جميع هذه الصفات المميزة لابيانات وأكثر. القاعدة نفسها 
مشابهة لسكول.لفة استعلام قاعدة البيانات المعروفة مسيقاً لك أو مرفقات البرمجة خاصتك. 

بك 2008 دعم لینکو من أجل جداول قاعدة بیانات مخدم سکول 5۵۷8۲ ا580 والکائنات(من لینکو إلى سکول ا5۵ ٥ا‏ 1|۵ )مجموعات بیانات آدو دوت 
نت ۸20.٤۲‏ (من لینکو إلی آدو دوت نت ۸250.۴۲ ٥ا‏ 1|۵ ومن لينكو إلى مجموعة البيانات 5ه ها NQ‏ |1 ).تجمعات الكائنات في الذاكرة مثل المصفوفات أو 
التجمعات العامة oااcمااco Generic‏ (من لینکو إلى الکائناتsاcە‏ ز0 L|NQ t0‏ )»و ا (XM‏ من لینکو إلى t0 XML :X× ML‏ L|NQ).مباشرة‏ بعد التحریر الرسمي 
لفيجوال أستوديو 2008 أطلقت ميکر وسوفت إطار عمل كينونة الدوت نت AD0.NE۲ Entity ۴r "e W0)‏ (لینکو إلی الکینونات5 L|NQ t٥ E۴"‏ )ءوالتي توفر دعم 
لينكو محسن لمخدم سكول۲ 58۲۷6 5۵1 .أوراكلهاعة0۲ . 082.ومنصات قواعد البيانات الأخرى.هذه بداية عظيمة ولكن الأخيار الجيدة لم تنتهي هناك. 

إن لينكو قابلة للتمدد(التوسعهاطاء١ها×ه‏ ).وهذا يعني أنك تستطبع تحسين لينكو بحيث تستطبع الاستعلام عن أي نوع من البيانات تعينه.من لينكو إلى اللوحة الجدولية 0 ۸×Qا_‏ 
readsheetمSp.من‏ لینکو إلى ملف مؤشر (محدد)بمنظم جدولي !۵-۴¡ NQ t٥ ۲2-Di"‏ |1 »ومن لینکو إلى محتوى مقطع ديفيدي LINQ to DVD-Chap6-‏ 
Content‏ كل هذا متاح.بقدر الإثارة لكل هذه الإمكانيات.فليس لدي مساحة كافية في هذا الكتاب لأريك كيف تبرمجهاءوكذلك توجد أخبار سيئة قادمة. 


لينكو نظام توسعي للاستعلام عن البيانات.فحالما تعمل على تأسيس اتصال بين عبارات الاستعلام والبيانات.فمن أجل بعض المواصفات المميزة للينكو.وخاصة (من لينكو إلى 
كائنات).لايوجد الكثير من الاتصال.لدلك فإن الاستعلام يكون خاطفاً .من أجل تنوعات لينكو الأخرى»وخاصة فرز قاعدة البيانات. عليك إنشاء فنات وسيطة والتي تربط متطلباتك 
بالبيانات.إن لينكو تقنية عمومية بإمكانها التفاعل مع أية بيانات حالما توفر المادة اللاصقة.وتلك المادة اللاصقة يمكن في بعض الأحيان أن تصبح لاصقة جداً. 

وكمثالءخذ لينكو إلى سكول.تنفيذ لينكو هذا يحتاج إلى فئة تمثل الجداول والسجلات والتي ستستعلم عليها خلال لينكو.وهذه الفئات ليست صعبة الإنشاء»وتيدو مثل جداول قاعدة 
البيانات الاصلية. 

مهما يكن»إذا عدلت تركيب جدولك»ستحتاج إلى تعديل الفئة الوسيطة لتنتفع من التفير ات الحاصلة على الجدول.إنها مهمة ستكون بحاجة لعملها على أية حال»حتى بدون لينكوءولكن 
هذا شيء ما عليك أن تضعه في ذاكرتك . 

طبيعة وسيط لينكو يعني أيضاً أن بعض معالجة البيانات يمكن أن تكون أبطاً عند مقارنة إتمام نفس المهمة بدون لينكو. الطبقات الاضافية من البيانات والكود يعني أشياء إضافية يجب 
على الكمييوتر عملها.ولكن يقطن هذا مسبقاً في إطار عمل الدوت نت.لذلك لن أتجنب لينكو من أجل هذا السبب. 


إن لينكو صفقة كبيرة بالنسية لميكروسوفت وإطار عمل الدوت نت.معظم الميز ات الجديدة المضافة إلى الفيجوال بيسك2008 تم تقديمها بشكل رئيسي لدعم لينكو.قبل أن ندخل في 
.تعابير الاستعلام0"5ادئهإم×ه راQue‏ .قلب(أو مركز)إمكانية الوصول للبيانات من خلال لينكو.يناقش هذا الفصل تعابير الاستعلام بالتفصيل. 

.تعابير لمدایءہ Lambda express‏ .التي تم مناقشتها في الفصل 9. 

.طرق التمدیدds Extension me٣۸٥‏ .التي تم تفطيتها في الفصل 12. 

.استنتاج النوع المحليعء٤١۴۲۴؟١¡‏ همر امعم 1ا .التي تم مناقشتها في الفصل 6. 

.الأنواع الغير مسماة كهمرا sامصرمهممةA‏ ءشيء ما جديد للفيجوال بيسك في2008.ولكن أيضاً شيء لم أناقشه حتى الآن.سأعطيك التفاصيل بعد الانتهاء من هذا المقطع. 
.التفاويض الحرة#5ا2وء امل ١ه×هاعR‏ .ميزة تتيح للفيجوال بيسك عمل تخمينات معتمدة على المعرفة والتجربة(ثاقبة) كما فيما إذا طريقة وتفويض يتطابقان أم لا.وهي مشابهة 
لاستنتاج(الاستدلال) على النوع»ولكن من أجل التفاويض »استنتاج التفاويض بدل الأتواع البسيطة. 

.حرفية 8ا ٣6زا‏ 1× الخاصيات المحورية ل ا ×.تعابير ا ×المضمنة(المغلفة).ودعم فضاء أسماء -ا۸×ضمن كودك المصدريءمن المحتمل أنك تتذكر كل ما يخص 
هذه الميزات من الشرح في الفصل13. 

.الأنواع"بدون قيمة #اطهااں ".التي تم مناقشتها في الفصل 6.مع بعض المناقشة الموسعة في فصل العموميات5ء 6٠٣6۲‏ .الفصل16. 

.الطرق الجزئيةء١ه‏ ٣اه"‏ اهنام۴ .أول ما ظهرت معنا في الفصل 8. 

.بادئات الكائن5٣z8:اها†¡İn Obj‏ .موضحة في الفصل9. 

.لغات أخرى وميزات مترجم ۴5اه اماامmهء‏ جديدة ولن تكون بتلك الأهمية بما أنها لم تحصل على أسماء جديدة مضبوطة مذكورة خاصة بها. 


الأنواع المجهولة‌الاسم ميزة جديدة في الفيجوال بيسك لدعم لينكوءولكن تستطبع استخدامها في كودك الخاص أيضاً.وهي بالضبط ما يفصح عنه اسمها:أنواع بدون أسماء. حستاً هذا 
ليس دقيق تماماً.الأنواع التي تملك أسماء.ولكن تم توليدها بشكل آلي من قبل مترجم الفيجوال بيسك»وهي لاتظهر بشكل مباشر في كودك المصدري.اعتبر فئة نموذجية تم تصميمها 
لحفظ معلومات على اختيارات السوشي أ٣كلاء‏ (طبق سمك ياباني). 
CIaSS SUSE‏ 
Public FishName As String‏ 
Public ServingCost As Decimal‏ 
ERG CIES S‏ 
إنشاء حالة من هذه الفئة بسيط جدا. 
Dim tastyFood As New Sushi‏ 
tastyFood.FishName = "maguro"‏ 
tastyFood.ServingCost = 3.5@‏ 
أو .باستخدام قاعدة مُسند الكائن ۲ع2/2/٣/ ٥6/١٠۴‏ التي تحدتت عنها في الفصل 9.تستطيع إنشاء حالة وملئ حقولهاء الكل في عبارة واحدة. 
Dim tastyFood As New Sushi With {.FishName = "maguro", .ServingCost = 3.5€}‏ 


تأخذ الأنواع المجهولة الاسم هذا التركيب المصقول مع خطوة أبعد من ذلك وذلك بشطب اسم الفثة تماماً. 
Dim tastyFood = New With {.FishName = "maguro", .ServingCost = 3.5@}‏ 


الحالة ٠١١‏ ۴راهاهي الآن حالة من فئة ما مع عضوينءنصي مسمى٥ع‏ ”.١١ء۴‏ .وقيمة عشرية مسماة اكه و” ا۷٣‏ ه5.الشيء الوحيد الذي ليس لديها هو اسم الفئة وهو معروف 


بالنسبة لك.ولكن الفيجوال بيسك تعرف ما هو.من أجل الترويح عن النفس قمت بترجمة ذلك المقطع الأخير من الكود وبحثت عن الاسم لانوع المولد .وهو التالي: 
UES ANONYMOUS VEE O ATO‏ 


ما هو مهم حقاً هو أن الفيجوال بيسك عملت على إنشاء نوع عمومي(شمولي) مع نوعي وسيط لحافظة (حاجز مان۲5 ٥اه‏ ۸ءacام‏ arameterم type‏ ): ۲0 (من المحتمل أنه 
متصل بالعضو النصي 2۳٥‏ ۸۸ءا۴) و 11 (من المحتمل أنه على صلة ب اه٥‏ و” اه8 العشري). 

الأنواع المكيولة الاسم هي تهات ر فة لقاع الو ع كفن الجوال سك نوع الفانات أكل فهو الماد على الغاات الي رواخ كل أ فى الات كنك 
العضو Cos‏ وrvinهSمن‏ نوع العشري اة"iء‏ م0 بالا عتماد على محرف العشري € المزود مع تعريف الحالة. 


تتبح لك لينكو الاستعلام عن البيانات من عدة مصادر مختلفة للبیانات. وکل تفاعل لینکو على بیانات ۸٣٥|ا٤‏ 6۲ہ¡ -data‏ هt-NQ‏ |1 يتم إدارته بواسطة موفر لینکو L/۸N@‏ 
rider‏ .لقد عملت على جدولة الموفر ات المضمنة في الفيجوال بيسك2008 بعد قليل.فجميعها لديها الاسم"لينكو على أي شيءو”/۸ ٥077ء‏ ه† NQ‏ |1 "بالنسية لي 
الموفرات الأبسط هي لينكو على كائنات. المصممة للتفاعل مع مجموعات الكائنات في الذاكرة. تتيح لك لينكو على كائنات معالجة استعلامات معتمدة على تجمعات كائن أءعزاه 
ections‌ااco.مصفوفات‏ فیجوال بيسك.وأي کائن یدعم واجهات الدوت نت eاطھe۲ 1٤" u n‏ أو(۲ e)0۴اumerab En‏ »من ضمنها التجمعات الخاصة بك.( الكائنات المتنوعة 
ضمن عالم آدو دوت نت ۸00.٤۲‏ تدعم هذه الواجهات»ولكن هذ الأنواع تقع تحت موفر لينكو على مجموعة بیانات6؟ ھ٥ NQ k٥‏ | »سیتم مناقشتھا بعد قلیل).عندما 
تشفل لینکو علی استعلامات کائنات LINQ to Objects ٩6۲٥5‏ > فمخرجات الاستعلام هي مجموعة جديدة من الكائنات التي تحتوي مجموعة جزئية من بيانات كائن المصدر 
الاصلي.يتيح لك هذا تشغيل استعلامات بقول الاشياء ك"مرحباً لينكوأعطني أسماء هؤلاء الموظفين وخصوصياتهم فقطءمن هذه القائمة للموظفين وخصوصياتهم »والذين تم توينهم 
في التسعين يوم الماضية".هذا يعمل على إنتاج مجموعة.ء أي تجمع معتمد على ماطة۲هم”ن٠عاءيمكن‏ أن يتم الاستعلام عنه أبعد من ذلك أو يتم استخدامه كلما احتجت لأي تجمع 
أخر في كود الفيجوال بيسك. 


قبل الدخول في موفر ات لينكو الأكثر تعقيداًءدعنا نستكشف قواعد استعلامات لينكو باستخدام "لينكو على كائنءأءهزط0 ها NQ‏ | و”اوں ".في المقاطع القليلة القادمة»سأستخدم 
تجمعين صغيرين في الذاكرة من الكتب كبيانات مصدرية لاستعلامي.إليك تعريف الفئة من أجل كل كتاب والذي يتضمن القليل من الأعضاء المقبولة. 
Class Book‏ 


EUDLTE MELE AS SEEING 

EUG E AWEROEID AS SEEING 

Public Pages As Integer 
End Class 

يظهر المؤلفين ۸10۲5 في فئة.حالات الكتب والمؤلفين تتطابق من خلال الحقل المشترك ٥۲۱٥۸ا Au‏ . 

Class Author 

EUBL Me AWE NOETID AS SEE INO 

Public Ful lName As String 
End Class 


. سأعمل على إنشاء تجمعات صغفيرة لاإدارة المؤلفین ۸0۲5ا ھوالكتبو)ەەط‎ 
Dim Writers As New Generic.List (Of Author) 
Dim Library As New Generic.List (Of Book) 
Writers.Add (New Author With {.AuthorID OES SEO UINamMeE — "TOLSEOV, LEON) 
Writers. Add (New Author With {.AuthorID "LW", .FullName = "Wallace, Lew"}) 
WEIEeES. AddA(New Author WIEN {.AUcEMOEID IIB, EuUllIName > "Barrie, U. M.T) 


Library.Add (New Book With {.Title = "War and Peace",.AuthorID = "LT", .Pages = 1424}) 
Library.Add (New Book With {.Title = "Anna Karenina", .AuthorID = "LT", .Pages = 976}) 
Library.Add (New Book With {.Title = "Ben-Hur", .AuthorID = "LW", .Pages = 544}) 
LLbrary. Add (New Book With {.Title = "Peter Pan",.AuthorlD = "JB", .Pages = 192}) 


لجعل فهمنا أسهل لمخرجات كل استعلام»دعنا نتظاهر أننا قد كتبنا طريقة تعرض نتائج أي استعلام في نموذج جدول.سأستدعي الروتين ئااuا6sمS!0WR؟‏ . 


یتم بناء تعابیر لينکو من شر وط استعلادئعءuواء‏ رعاو لديها نفس الصفة الخاصة كما في شروط عبارات سكول على مستوى قاعدة البيانات. مع استثناء شرط ۳٠۴۴ء‏ والذي 
يجب أن يظهر أولاء الشروط الأخرى يمكن أن تظهر في أي ترتيب ضمن الاستعلام بشكل عام 


." ۴۲0۳١ 1اأساسي بيدأ بالكلمة المحجوزة "من‎ N۵ كل استعلام لينكو‎ 
DIm boOkKBag +z BION Gk In MOTFaAEY 
ShowResults (bookBag) 
' Results --> War and Peace LT 1424 
' Anna Karenina LT 976 
' Ben-Hur IW 544 
' Peter Fal JB 192 


هذا الاستعلام المكون من أربع كلمات إلى حدما أقصر استعلام لينكو تستطبع كتابته.عملت على تخزين نتائج الاستعلام في المتغير وه0۸8٥٠(حيث‏ يتم الاستدلال على نوع بياناته 
بواسطة الاستعلام)»ولكن يمكن أن يتم استخدام الاستعلام مباشرة كتعبير أيضاً. 
SROWRESULES (BEOM BE MM HDEAEY)‏ 


الفصل السابع عشر:الاستعلام المتكامل للغة هاا Mhm76‏ 
المتغير ۸ط المضمن في الاستعلام يعرف بمتفغير مجال ا2/٣۷2‏ هو۲2۸ أو متغير دور ان #اbةأ/۷2‏ ۸٥0/او/6/‏ (ليس عليك استخدام )0 ءفقد اخترت هذا الاسم بشكل 
عشوائي»فهو متغير لذلك امنحه الاسم الذي تريد) يوفر هذا المتغفير طريقة لتحدید کائنات وأعضاءها من مصدر بیانات ضمن ۸۱۸٤ا‏ ۷الاستعلام.بما أن ۲۲۷ طا اهو تجمع.فلیس من 
المعقول القول ٠!٥‏ .ر2۲١‏ طا عند الإشارة إلى عنوان كتاب فقطبالمقابل تشير إليه ب ها.)ط. 
شخصياًءإني أرى هذه القاعدة ٠0ء 4/4/٥ |٠١‏ نوعاً ما غير مياشرة .والأفضل أكثر قاعدة الاسم المرادف -للجدول كهااه-هاطهاالمستخدمة في استعلامات سكول. 

SELECT * FROM Library AS bk 


تنجز كلمة سكول المحجوزة ۸8 إلى حد بعيد نفس وظيفة كلمة لينكو المحجوزة١!‏ .بالرغم من قلقي الداخلي.فإن القاعدة ٠١‏ هي السائدة.فلن تستطيع استخدام التركيب Sهفي‏ لينكو 
بما أن الكلمة المحجوزة Sهفي‏ الفيجوال بيسك يتم استخدامها لاسناد نوع البيانات. 


إذا استخدمت الشرط "من ۴٠۳‏ " فقط في استعلامك.فإنه يعود بجميع البيانات من مجموعة الكائن الأصلي.متضمناً جميع الأعضاء.إذا كنت تريد تحديد التتائج بحيث يتم تضمين 
بعض الأعضاء فقط استخدم الشرط ء٠اه5‏ لتحديد الحقول التي يجب أن يتم تضمينها. 
Dim bookBag = FErom bk In brary Select bk .AUCHNOEID, SK. Title‏ 
ShowResults (bookBag)‏ 
Results --> LT War and Peace‏ ' 
[LT Anna Karenina‏ ' 
1W Ben-Hur‏ ' 
JB Peter Pan‏ ' 
مجموعة التتائج لهذا الاستعلام الجديد يحذف عدد الصفحات الموجودة في البيانات الأصلية.وهذا لأن استعلام لينكو طلب فقط حقل معرف المؤلف ۸٣0۲١١‏ وحقل العنوان ٠‏ !آ٣‏ ؛ 
ولم يتم عمل استعلام على العضو ك٠وة۴من‏ خلال الشرط †ء#اه5.لاحظ أيضاً أني عملت على عكس ترتيب كل من حقول معرف المؤلف والعنوان من تعريف الفئة الأصلية.وهذا 
القلب تم عكسه في النتانج المطبوعة أسفل الكود السابق باللون الأخضر. 
ماوراء الكواليس.تعمل لينكو على إنشاء نوع جديد مجهول الاسم €٥مر anonymous‏ سع" والذي يتضمن عضوين: حقل (0١١٥۸اں4النصي‏ وحقل اأ النصي.حالة واحدة 
لھذا النوع المجھول الاسم یتم إنشائھا من أجل کل سجل استعلام ناتج tant u۷ ۲۴٥٥۲۵‏ اresu‏ .ومن ثم يتم تحزيم ما ١عال”اط‏ هذه الحالات في تجمع جديد معتمد على 
Enumerable(Of T(.‏ .یتیج لك هذا استخدام نتائج الاستعلام في استعلام جديد. أو في أي كود سيتفاعل مع تجمع من النتائج بشكل طبيعي.مثل العیارة .۴۵١ ٤2۸‏ 
DIm boOKBAaAS > HOM bk In Morar y Selec E DK .AUERNOEID, SK. TEE‏ 
For Each oneResult In bookBag‏ 
MsgBox (oneResult.Title)‏ 
Next oneResult‏ 
The Loop Displays --> War and Peace‏ ' 
Anna Karenina‏ ' 
Ben-Hur‏ ' 
Peter Pan‏ ' 


بالاضافة إلى ترحيل الحقول من الكائنات الأصلية إلى مجموعة النتانج.تستطبع استخدام المعاملات والدوال لتعديل النتانج.فالمثال التالي يستخدم الدالة م5إ٠۷٠81۲8لتبديل‏ اسم 
العنوان قبل ترجمة النتائج. 


Dim backward = From bk In Library Select StrReverse (bk.Title) 
ShowResults (backward) 
' Results --> ecaeP dna ralW 
'"' anineraK annA 
' ruH-neB 
' naP reteP 


بشكل افتر اضي»يعمل الشرط ٠٠اهSعلى‏ إعادة جمبع السجلات من المصدر.فالحصول على معلومات كاملة شيء جيد.ولكن في بعض الأحيان إن الكثير من الأشياء الجيدة. 
تحتوي تكرارات .على سبيل المثالء يعمل هذا الاستعلام على إعادة معرف المؤلفين فقط من أجل كل كتاب متاح. 
Dim justIDs = From bk In Library Select bk.AuthorID‏ 
ShowResults (justIDs)‏ 
JT RESUS SS UE‏ 
E‏ 
1W‏ ' 
5ا 1 
التتائج كاملة »ولكن ظهر ١ا‏ مرتين.بالاعتماد على حاجاتك من المحتمل أن يكون ذلك شيء سيء.بإضافة الشرط اء٠ناءاط.‏ تستطيع التخلص من(أو استثصال اث ١e۵س)‏ 
التكرار الغير مرغوب. 
Dim juUsElDSs > HEOM Ok IM UIGrarEY Selectét DOK. AUCROEID DISEINEE‏ 
ShowResults (justIDs)‏ 
RESUS SS EL‏ [ 
TW‏ ' 
5ال ٣‏ 


تنظر الكلمة المحجوزة اء”ناءاطعلى كامل السجلات من أجل التكرارات.يتم إخراج السجل فقط إذا كانت جميع الحقول في ذلك السجل تطابق تماما جمبع الحقول في سجل آخر. 


بينما يتبج لك الشرط استئصال اناه ٠٠۵١‏ الحقول الغير مرغوبةءيتيح لك الشرط استبعاد ٥2١ا"‏ ااهكائنات كاملة بالاعتماد على معيار هأ٣‏ ا۲ء تعينه أنت. 
Dim bigBooks = From bk In Library Where bk.Pages >= 1000‏ 
ShowResults (bigBooks)‏ 
Results --> War and Peace LT 1424‏ ' 


يختبر هذا الاستعلام جميع سجلات المصدر القادمة في تجمع المكتبة رهطا اويعمل على تضمين كائنات المصدر في النتائج إذا كانت فقط لديها عدد صفحات 1.000 أو أكثر. 
یمکن لشرط آن یصبح معقداً.مع ضم معايير متعددة من خلال الكلمات المحجوزة ۵١١۸و0۲‏ .وتجميعها ضمن أقواس. 
Dim choices = From bk In Library Where bk.Pages >= 1000 Or (bk.Pages < 1000 And InStr (bk.Title, "-") > 0) Select‏ 
bk.Title‏ 
ShowResults (bigBooks)‏ 
Results --> War and Peace‏ ' 
Ben HUE‏ 1 


بيين هذا الاستعلام كيفية تضمين ميزات لا تمت إلى لينكو بصلة مثل الدالة |۸5١‏ .في المعابير»مما يسمح لك بتقييد النتائج بالاعتماد على نتائج محسوبة. 


من غير المضمون ظهور نتائج لينكو .المعتمدة على مصدر بيانات.في أي تر تيب معين .لإنتاج نتائج استعلام في ترتيب معينء استخدم الشرط"ترتيب بواسطةر8 0۲06۲ ".الكلمات 
المحجوزة 8۷ 0۲6۲ تسبق واحد آو آكثر من حقول المصدر آو القيم المحسوبةء أو المحددة بواسطة الفاصلةءوتستطبع بشكل اختيار ي تضمين الكلمة المحجوزة تصاعدي 
Ascending‏ أو تنازلي و”iكہهمعsه0لمكس‏ ترتيب الفرز لكل حقل مفروز.( الفرز التنازلي هو الافتراضي لكل حقل) 
Dim bookBag = From bk In library Select bk.pages, bk.title Order By pages Descending‏ 
ShowResults (bookBag)‏ 
Results --> 1424 War and Peace‏ ' 
Anna Karenina‏ 976 ' 
Ben-Hur‏ 544 ' 
Peter Pan‏ 192 ' 
ملاحظة 


إذا كنت لا تريد إظهار النتانج بواسطة الروتين 5100001١‏ .اعمل على إنشاء الفئة التالية: 


أضف إلى الفورم صندوق80×1ءأا قائمة ومن ثم في معالج حدث تحميل الفورم اعمل على إضافة الكود التالي: 


الحقول المضمنة في الشرط ر8 0۲۵6۲ يجب أن يتم إحضارها في الشرط †ء٠اه5.مع‏ التخلي عن سابقة متغير المجال( أي في هذه الحالة order By bk.pages ... بiكت IJ‏ ( 
إذا استخدمت الشرط ١۳١۴۴دون‏ الشرطأءهامS‏ .عليك تضمين سابقة متغير المجال في حقول 8y‏ ٣6ك0.‏ 


إذا كنت تريد فقط الاستعلام عن البيانات من تجمع بيانات أو مصدر مفردءمن المحتمل أن لاتحتاج إلى شيء مثل لينكو في المكان الأول.عندما يحين الوقت لدمج النتائج من جداول 
مختلفة.يوفر مرةً أخرى لينكو تركيب مشابه لسكول لضم الجداول.عملياً إنه يوفر تشكيلنينتوازيان تشكيلات التر كيب المدعومة من قبل بائعي سكول. 
القاعدة الأولى تستخدم الكلمة المحجوزة "ضم ١هل‏ "لتعين وصل حقل معين.الاستعلام التالي "يضم داخليءہ اهز |٠٣۴‏ " الجدول اه۲ طن اوالجدول ء#۲ا۷۷۴عند نقطة الاتصال 
Dاuthor A‏ lالمتوقعة.‏ 
im bookBag = From bk In Library Join au In Writers On bk.AuthorID Equals au.AuthorID Select bk.Title,‏ 
au uIIName OEdez By OK I1 le‏ 
showresults (bookBag)‏ 
Results --> Anna Karenina Tolstoy, Leo‏ ' 
Ben-Hur Wallace, Lew‏ ' 
Peter Fan Barrie, U. WM.‏ ' 
War and Peace Tolstoy, Leo‏ ' 
الكلمات المحجوزة الخاصة ١0و‏ كاةسوعتساعد في إتمام تركيب الربطإذا تضمن الربط خاصتك عدة مفاتيحتستطبع استخدام الكلمة المحجوزة ١‏ ۸لتخصيص ربط المفاتيح 
Dim results = From t1 In Tablel Join t2 In Table2 On t1.Key1 Equals t2.Key1 And t1.Key2 Equals t2.Key2‏ 
يتبح لك استخدام الشرط ١۲٠٣۷للدلالة‏ على روابط الحقول. 


Dim bookBag = From bk In Library, au In Writers Where bk.AuthorIlD = au.AuthorID Select bk.Title,u.FullName Order By 
bk.Title 


E TO ETE E 
تتضمن لينكو تشكيلة أخرى للربط تولد نتائج استعلام هر مية التنظيدئ)/ائع/ ر/عuو /aء/۸ءa/c/ع// .في مثل هذه الاستعلامات»واحد من الحقول في کل سجل ناتج سيكون تجمع‎ 
»حيث أن كل سجل مؤلف يتضمن حقل"الكنب 000۸5 ".ومن‎ ۲٠۷ يحتوي نتائج متعددة.ويسمح هذا التركيب للينكو بالعمل على إعادة قائمة بجميع المؤلفين»مؤلف في كل صف‎ 
المحتمل مع قيم متعددة.‎ 
Dim authorBooks = From au In Writers Group Join bk In Library On au.AuthorID Equals bk.AuthorID Into 
Published = Group Select au.FullName, Published Order By Full1Name 
ShowResults (authorBooks) 
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' Results --> Barrie, J. M. Peter Pan 
' Tolstoy, Leo War and Peace 
' Anna Karenina 
' Wallace, Lew Ben-Hur 


هذا الاستعلام لديه نوعاً ما تركيب غريب»ولكن يعمل بنجاح على إنشاء مجموعة نتائج مع عمودین:الاسم ١2۳٩‏ |ان۴(من أجل اسم المؤلف) والمنشور ۵٥۸ءااطاں۴(من‏ أجل 
تجمع من الكتب المنشورة من قبل مؤلف معين).من أجل كل سجل معاد العضو ١٠٠ءأاطنا‏ هو تجمع تابع يمكن أن يتم معالجته مثل التجمعات الأخرى. 


يتبج لك الشرط تخطي ما)5السجلات الأولى بعدد ×في مجموعة التتائج.وبصفة مؤثرة إلقائهم مع النفايات.مثل قشور الموز.يعمل الشرط ١۴٠٣العكس‏ تماماًيحفظ فقط أول عدة 


سجلات في النتانج المولدة. الاستعلام التالي يتخطى السجلين الأولين في تجمع البيانات الأصلي»مرجعاً فقط تلك السجلات التي تتبع القيم التي تم تجاهلها: 
Dim someBooks = From bk In Library Select bk.AuthorIlD, bk.Title Skip 2‏ 
Results --> IW Ben-Hur‏ "' 
OBE Eee EEN‏ 


تبج لك الشروط ءان٣۷۷م)Sو‏ هااا هه ذات الصلة استخدام تعبير منطقي بدل عدد ما للدلالة على متى سيستمر تخطي أو أخذ سجلات.إن كل من م)؟و #)ةامفيدة من 
أجل تصفح النتائج عند عرض صفحة واحدة فقط من النتائج في كل مرة من مجموعة أكبر من النتائج المستعلمة.فمنطق مشابه للتالي يمكن أن يتم استخدامه لإظهار السجلات 
المقر رة للصفحة الحالية مو2 ٤۲۴‏ ء٣Cur‏ فقط 


Dim onePageWorth = From bk In Library Select bk.AuthorlD, bk.Title Skip ItemsPerPage * CurrentPage Take 
LESS ES EOS 


كلمة تحذيرية بخصوص م« 81و٠۴١۲‏ :إنها تعمل على صنع اختلاف عندما تضعها في استعلامك.(سأشرح السبب التقني لهذا في مقطع التنفيذ المؤجل.فيما بعد في هذا الفصل)على 


سبيل المتالءخذ هذا الاستعلام المعتمد على بيانات كتاب الأصلية 
Dim someBooks = From bk In Library Order By bk.Title Take 2‏ 


هذا الاستعلام يعمل علی إعادة A٣2 ۸2٥٣٣2‏ متیوعاً ب ٠٣-٣٣‏ 8.كما ستتوقعءولكن إذا نقلت شرط خطوة.ستحصل على نتيجة مختلفة: 
Dim someBooks = From bk In Library Take 2 Order By bk.Title‏ 


هذه المرة ءسیعمل الاستعلام على إعادة Ana 6٣٣2‏ متبوع ب ۴e2‏ له .في الاستعلام الأولءتم تخزين محتوى بواسطة العنوان قبل أن يتم أخذ السجلين.في 
الاستعلام الثاني تم أخذ السجلين أولاءوقبل أن يتم تطبيق أية عملية فرز عليهم. 

لايتأثر فقط ٠هو‏ بهذا الترتيب.جميع الشروط في استعلامك تتأثر .فالتفكير بمنطق استعلامك شيء أساسيءبما أنه يمكن للشرط الموضوع في غير مكانه أن يعطيك نتائج 
غير متوقعة. 


بما أن أي نتائج لأي استعلام لينكو تتوافق مع الواجهة(۲ 0۴)٥اطه۲٠”٠ں٣ع|‏ .فهي جاهزة لان يتم استخدامها مباشرةً في استعلامات أخرى أو في ماسحات عددية 
scans‏ eاumerabمe.‏ إذا كنت بحاجة الوصول إلى السجلات بطريقة تقليدية من أجل أهداف أخرىءتوفر لينكو العديد من الميزات التي تعمل على نقل النتائج بسرعة ضمن 
مصفوفة 2۲۲۵۷ أو تجمع eعمومي generic collection‏ . 
تتضمن كل نتيجة استعلام تلات طرق تعمل على إنجاز هذه التحویلات: إلى مصفوفة yھ۸۲۲٥۲‏ إلى قاموسر۲ 2ˆ هت0٥۲‏ . وإلى قائمةءناه۲ .تحول ۷ھ۸۲۲۵١٣النتائج‏ إلى 
مصفوفة فيجوال بيسك قياسية»مع سجل نتيجة واحد يتم تخزينه في كل عنصر مصفوفة. 
Dim queryResults = From ...‏ 
Dim arrayVersion = queryResults.ToArray ()‏ 
يقوم ءا٥٣۲‏ بنفس العملية» إنشاء تجمع ءا ٥.‏ مم6 جدید بالا عتماد على نتائج الا ستعلام.یعمل 2۲y‏ هiا¡D0ه۲‏ على إنشاء تجمع nay‏ ioاGeneric.Di.ولکن‏ يجب عليك توفیر 
دالة Dict"‏ تستخرج المفتاح.في معظم الحالاتءتعبير لامدا الذي يحدد حقل المفتاح ١۱ء‏ إه) الذي سيفي بالغرض. 
Dim authors = From au ln Writers Order By aãu.Ful IName‏ 
DAM @AUERnOrDILEE — AUERNSES  TODTEEI ONA V(EURNE ENON (xX) xX AUERNOE LD)‏ 
ListBoxl. Items. Add (authorDict ("LW") .Eull1Name)‏ 
MSGBOX (aUEROEDECE (E ENT EU IName)‏ 
ReSWEES 2 > Wallace, Le‏ [ 


تتيح لك استعلامات لاإجمالي"تحصيل صا اء "المعلومات من استعلام أكبر ضمن نتيجة مفردة أو مختصرة(مكثفة 0١١٠١560‏ ).بدل البدء بالكلمة المحجوزة ۳٥۴۲ء‏ 
فاستعلامات الحاصل النقية تبدأ بالكلمة المحجوزةهاةو٠۲‏ ووه .كل استعلام إجمالي يستخدم واحد أو أكثر من دوال التجميع(أو الإجمالي,ء٣٥ناع"u/‏ ماجوe/ووه‏ ).مثل الدالة 
كفي الاستعلام التالي: 
Dim numBooks = Aggregate bk In Library Into Sum (bk.Pages)‏ 
MSJBOX (NUMBOOKS) [ DISplaySs: 29196‏ 


تتضمن لينكو ثماني دوال اجمالي قياسيةمبينة في الجدول التالي.تقبل كل دالة تعبير يشير إلى ما يجب أن يتم تجميعه خلال الاستعلام. 


مشابهة للسابقةءولكن تعود بصواب إذا كان واحد فقط من السجلات يتطابق مع تعبير المعيار المزودة به. 
تعود بإاحصاء السجلات مع نتائج تعبیر صواب ۵eں٣۲‏ .للعودة بعدد جمبع السجلات في استعلام استخدم(۲ue Cou) ٣‏ . 


ETE TT TET OEE 


Sum‏ تعود بمجموع تعابير عددية من مجموعة سجلات. 
لو عملت على تضمين أكثر من دالة إجمالي في الاستعلامءفإن مجموعة النتائج هي سجل وحيد يتضمن عدة حقول مسماة(مميزة بالاسم).استخدم الاسم المستعار 5ه أاهقبل دالة 
الإجمالي لمنحها اسم.(الأسماء المستعارة متاحة في جميع أنواع الاستعلام»وليس فقط في الاجمالي). 
Dim numBooks = Aggregate bk In Library Into TotalPages = Sum (bk. Pages), AvgPages = Average (bk. Pages)‏ 
MsgBox (numBooks.AvgPages) ' Displays: 784‏ 


تستطيع أيضاً تضمين تعابير إجمالي في استعلام قياسي لايمت إلى الاجمالي بصلة.يعود الاستعلام التالي بعدد الكتب المكتوبة بواسطة مؤلف.» باستخدام دالة الإجمالي" إحصاء 
"count‏ لجمع نتائج کل مؤلف: 
Dim aUERoOEFEOOKS — HOM aU IM WEIEeES GEOUPD ION BKE IM LIBLarEY On au. AUENOor ID BOUALS DK. AUENOEID INES‏ 
NumBooks = Count (True) Select au.Ful LIName, NumBooks Order By Ful lName‏ 
'ShowResults (authorBooks)‏ 
RESUMES => Bartle, U. M1‏ ' 
TONS EOV, Meo 2‏ 
Wallace, Lew 1‏ ' 
EOE Each au In @AUEMOrBOOKS‏ 
ListBoxl1.Items.Add(au.FullName & vbTab & au.NumBooks)‏ 
Next‏ 


من المحتمل أنك تتذكر من الفصل9 أن تعابير لامدا يتم تحديثها من قبل المترجم ضمن شيء أبسط .في حال فشل استعلاماتك في جزيئات أقل من حجم الذرة.فإن المعالج ٥U‏ ° 
جاهز ليتصرف.ولكن ليس عليك البدء بالاستعلامات الكاملة.تستطبع إنشاء استعلامات خاصة بك باستخدام طرق التوسبع ۸٥ء٣‏ 6ا×ھوتعابیر لامداة ۵ط ه| .يتم إرفاق الطرق 
الموسعة التي نتكلم عنها إلى واجهة #اطة۲ه٠ "u‏ ع|.وهذا يعني أن أي شيء يبدو مشابه لتجمع أو مصفوفة يمكن أن يتم تضمينه في استعلامات معتمدة على طرق التوسيع, 
باستخدام تعابير لامدا كمعاملات نسبية. 


لنعمل على تحويل واحد من استعلاماتنا السابقة إلى طريقة التوسيع ٤‏ ١0اه"‏ ١0اءممextالنظيرة.‏ 
Dim bigBooks = From bk In Library Where bk.Pages >= 1000‏ 


إنه الاستعلام الذي يعود بالكتب الكبيرة فقط .نفس الاستعلام الذي يستخدم طرق التوسبع يبدو مشابه للتالي: 

Dim bigBooks = Library.Where (Function (bk) bk.Pages >= 1000)‏ 
في هذا المثال الطريقة"حيث ۷٠۲١‏ "هي بالفعل طريقة توسبع لواجهة٥اطةe۲ u”‏ "۱۴ .ولتي تتځضja‏ ÎيذÎ Min.Max « Count«GroupJoin «Join «OrderBy «Select‏ 
وطرق أخرى تتوافق مع المعاملات ضمن لفة استعلام لينكو.وكما شرحت في الفصل12.بإمكانك إضافة طرق التوسيع الخاصة بك إلى الواجهةهاطة۲"ں "ع1 مما يمنحك حتى 
طرق أكثر لتخصيص استعلامات لينكو التي تقوم بها 


قدمت في الفصل13 حرفيات ۷1× . محتوى 1× الذي يتم تضمينه في الكود المصدري للفيجوال بيسك تماماً.عندما تضع لينكو في الصورة.فسيكون لديك فجأة طريقة لتوليد 
مستندات 11× ضخمة وذلك بضم مجموعة من السجلات مع قالب الحرفية د ۷/1/×. 
المقطع التالي من الكود يعمل على إنشاء مستند ا ×باستخدام كل من تجمع 4۲ط ناوتجمع ء٠از/۷۷الذي‏ عملناهما سابقاً في بداية الفصل.ودلك بممازجة لينكو و ا١×‏ 
بطريقة تعمل صداع في راسي. 
DIM Sook AML AS XDocumen e > |‏ 
xml veESION Sl OL‏ 
ool TEE‏ 
e> ErOM bk IM TibraEY JOIN al IN Writers OM BK. AUENOrID EGUals aU. AUCNOFE ID Order BY‏ 
bk.Title Select‏ 


<book> 
<E1Eles<s= Bk. TIlE S></EICle> 
<author><%= au.Ful1lName %></author> 
<pages><%= bk.Pages %></pages> 
DOK 
EOSIN NS ES 
bookXML. Save ("books. xml") 
لاحظ كيفية توجب وضع رموز استمرارية السطر في الكود الخاص بلينكو.ولكن ليس في حصة ا0 ×.في الواقع إني أكره هذاءولكن ألم يعمل على إنتاج ۷1× جميل.إذا ألقيت‎ 
الناتج عن هذا الکود.فإنه یحتوي محتوی مدمج من 1× و تجمعاتنا الأصلية.ولقد تم ترك فراغات بشکل جمیل.‎ 00٥0۸5.×/7/ نظرة على ملف‎ 
<?xml version="1.0" encoding="utf-8" ?> 
= <booklist> 
- <book> 
<title> Anna Karenina</title> 
<author>Tolstoy, Leo</author> 
<pages>976</pages> 
</ book> 
— <book> 
<title>Ben-Hur</title> 
<author>Wallace, Lew</author> 
<pages>544</ pages> 
</ book> 
- <book> 
<title> Peter Pan</title> 
<author>Barrie, J. M.</author> 
<pages>192</pages> 
</ book> 
- <book> 
<title>War and Peace</title> 
<author>Tolstoy, Leo</author> 


الفصل السابع عشر:الاستعلام المتكامل للغة |1 Mhm76‏ 
<pages>1424</ pages>‏ 
book>‏ /< 
booklist>‏ /< 
مفتاح تمازج ا ×ولينكو هو وضع المحددات =%>و<% حول كود تعيين لينكو.إذا ألقيت نظرة إلى العينة بحذر»سترى أن هناك مجموعتين من المحددات» واحدة داخل الأخرى. 
Eron ...‏ =%< 
<title><%= bk.Title %></title>‏ 
ا ب 
المجموعة الخارجية من المحددات تحيط كامل استعلام لينكوءبينما كل مجموعة داخلية من المحددات تعين متغير استبدال للتضمين في محتوى ا/۷×. 
بقدر سهولة إنتاج 1× باستخدام لينكوفهو سهل تماماً لاستعلام البيانات من مستندات ۷× الموجودة.لإعادة تحميل ا1 ×عملنا فقط على حفظه بما يسمح لنا الاستعلام عن 
قائمة عناوين الكتب بتمازج لينكو مع خاصيات ا ×المحورية. 
Dim bookXML As XDocument = XDocument. Load ("books.xml")‏ 
Dim fromXML = From bx In bookXML...<book> Select bx.<title>.Value‏ 
ShowResults (fromXML)‏ ' 
Results --> Anna Karenina‏ 
Ben-Hur‏ 
Peter Pan‏ 
War and Peace‏ 
EHO Each bk Im EFOMXMU‏ 
ListBoxl.Items.Add (bk)‏ 
Next‏ 


إن كل من آدو دوت نت ولينكو يعملان الان مع بعضهما بشكل جيدفي الحقيقةءيدعم آدو دوت نت ثلاثة موفرات لينكو. 


حالما أطلقت ميكروسوفت فيجوال أستوديو2008.أطلقت ميكر وسوفت إطار عمل كينونة آدو دوت iٽتmew0ork ADO.NET Entity Fra‏ .هذ lلugيþؤطة)lلlgجھة( interface‏ 
بين كودك البرمجي وقاعدة البيانات سيتبح لك تعريف عرض منطقي /4٥/09/لنظامك.على‏ سبيل المتالءتستطبع إنشاء كينونة ااا #تدعى "الجداولءه‌اطها ".الكل في عرض 
منطقي.ويمكن أيضاً أن تكون الإجراءات المخزنة 5إuل١هعه١م‏ ١٠0۲ء‏ ذات الصلة جزء من الحزمة. يقوم إطار العمل بعمل كل هذا السحر بإنشاء مجموعة وسيطة من الفئات 
ومحتوى ا0 ×التر كيبي ذو الصلة (المناسب) الذي يدير الربط بين المنطق والعروض الجسدية للبيانات.هذه الات يمكن أن يتم استخدامها فيما بعد في استعلامات لينكوءومؤلفي 
الاستعلامات لايحتاجون إلى القلق بخصوص الأمور العادية مثل اتصالات قاعدة البيانات ومراجع المفاتيح الأجنبية(الثانويةكءهء ۲٠٠٣٠٠٠‏ إه» ١وأه۲ه؟‏ ). في الحقيقةءإن 
المبرمجين قد كتبوا كود مثل هذا منذ سنوات»عاملين على تجريد(تلخيص) نمط البيانات الجسدي في عرض منطقي وهو أسهل لليرمجة عليه.يجعل إطار عمل الكينونة ببساطة هذه 
المعالجة أسرع وأسهل التثبيت. 

يتضمن إطار العمل عدة أدوات تساعدك في بناء الكينونات من تر اكيب قاعدة البيانات المصدرية.واحدة من الأدوات الرئيسية هي مصمم نمط بيانات كينونة آدو دوت نت 
.»AD0.NE۲ Entity Data Model Designer‏ أداة السحب والاإسقاط المرئية امه مه ك-"a-وهaاه‏ اهuءvi‏ التي تجعل إنشاء كينونات 5ا١6‏ بقدر سهولة إنشاء 
نماذج الفيجوال بيسك. 

ولأن إطار عمل كينونة آدو دوت نت تقع خارج الفيجوال أستوديو 2008.فلن أعمل على شرح إطار العمل في هذا الكتاب. 


تدعم لینکو استعلامات السجلات ضمن جداول بیانات آدو دوت نت.لاتدعم کائنات جداول بیانات اط۵ ٥1۲‏ ]دو دوت نت بشکل میاشر الواجھة ٥ا١٥‏ ں٣٤۴‏ فالحقول ضمن 
هذه الجداول وبشكل افتراضي غير محددة النوعك١‏ ٥مان‏ .مما يجعل لينكو يغفضب.يتفلب التخصص الوظيفي "لينكو على مجموعة بیانات 15و2 //NQ ٤٥‏ " على کل من 
هذين القصورين 5١٥ااهاا”‏ || لذلك فإن استعلام مجموعة البيانات كأهء هأهك يعمل. 
فيما سيق في هذا الفصل »شاهدنا أمتلة لينكو التي استخدمت فئة )800.دعنا نحفظ عينة البيانات تلكءولكن مع التظاهر أن البيانات تظهر الآن في نسخة جدول بيانات ماطة هم0 
آدو دوت نت .سيكون للجدول أربع سجلات (من أجل الكتب في مثالنا)وتلاث أعمدة :العنوانه!٠‏ .معرف المؤلف A٣0۲۱0‏ »والصفحاتءه وم۴ . 
Class Book‏ 
EubDlTE Tele AS SEEING‏ 
BUSlIE AUtnNOE ID AS SEEIDG‏ 
Public Pages As Integer‏ 
End Class‏ 


فبدلاً من إصدار استعلام لينكو على كائنات مثل التالي: 
Dim choices = From bk In Library Where bk.Field(Of Integer) !Pages >= 1000 Or (bk.Pages < 1000 And‏ 
TIDSEENBE TLI ElLe, 1D > O CENECE BE A e‏ 


يستخدم لينكو على مجموعة بيانات طرق تعين كائن مجموعة البيانات التي تجبر كائنات آدو دوت نت ضمن شيء ما حيث تستطبع لينكو التفاعل معه»وفي نموذج محدد النوع بقوة. 
Dim choices = From bk In bookTable.AsEnumerable () Where bk.Field(Of Integer) ("Pages") >= 1000 Or‏ 

(Bk. Eield(OE Integer) (Pagesl) < 1000 And Instr (bk .Eielda(OE String) (IT tlel), >") > Û) Select New With 
{.Title = bk.Field(Of String) ("Title") } 


إنها تبدو بطريقة مختلفة حقاًءولكنه نفس الاستعلام.فنسخة جدول البيانات" ءاطة١۸٥٠٠"هو‏ السجل الأول الذي بيدو مثل نسخة ماطة۲ ٠٣ن"‏ عامن خلال الطريقة 
.AsEnumerable‏ ومن تم»بما أن كل حقل مضمن في الاستعلام »فإن نوع بياناته تم التصريح عنها من خلال شروط 0 الشموليةءمتبوعة باسم الحقل ضمن علامات 

اقتباس.أخير ا لان.الاستعلام ليس لديه إمكانية وصول مياشرة إلى أسماء الحقولءفيتم إنشاء مجموعة النتائج باستخدام قاعدة "بادئ أو ممهد الكائن 26۲اهنا| ".إنها طريقة ملتوية 
undaboutدrآکثر‏ من لینکو علی کائنات کا زط0 ها 1|۵ .ولكن إذا كان لديك بيانات تقبع في كائنات آدو دوت نت التي في الذاكرة.فإن لينكو على مجموعة بيانات هي 
الطريقة المناسبة. 

يتضمن لينكو على مجموعة بيانات أيضاً دعم من أجل مجموعات البيانات "المحددة النوع١#م‏ ".ومجموعات البيانات التي تتضمن توصيف البيانات ه2 لها" الضروري 
لوصف نوع البيانات كاملا بالنسية لكل حقل.مع مجموعات البيانات المحددة النوعءلاتحتاج بشكل مستمر إلى حفظ مساعدة لينكو من خلال الشروط "من نوع البياناتهمر†هdat Of‏ 
"»سيعمل لينكو على استكشاف أنواع الحقول بشيء من الخصوصية.من أجل معلومات حول إنشاء مجموعات بيانات محددة النوع»راجع مستندات ميكروسوفت 180١‏ التي تأتي 
مع الفيجوال أستوديو. 


إن لينكو على سكول هو الموفر الذي يتيح لاستعلامات لينكو التفاعل مع قواعد بيانات سكول سرفر.بما أن مشروع المكتبة يستخدم سكول سرفر.»ستمضي وقت أطول على هذه 
التقنية.كما مع لينكو على كينونات»فإن لينكو على سكول يعمل من خلال الفتات الوسيطة.على الرغم من أنك ومن المحتمل أن توفر عرض منطقي مختلف لجداول البيانات الجسدية 
باستخدام لینکو على سكول»يوجد أكثر من توقع لأن تكون كائنات لينكو على سكول أكثر شبهاً بجداول قاعدة البيانات المضمنة. 

يتضمن لينكو على سكول أداة».مصمم الكائن العلائقي €^ Object Relati0n2/ )0/۸( 2es/9‏ .والذي سيساعدنا في إنشاء الفثات الوسيطة.تستطبع أخذ نظرة خاطفة على 
الشكل التالي لرؤية ما يبدو عليه.ما يزال يقوم بعمله المتوقع عند عمل اتصال قاعدة البيانات الضروري.المصمم العلائقي للكائنات هو مجرد سحب وإسقاطء وهو مناسب لقواعد 
البيانات التي لا تكون كبيرة بشكل فظبع.إذا احتجت إلى إنشاء فئات اتصال لقاعدة البيانات.والتي لديهاءمثلاًء المنات من الجداول.فعليك اكنساب المعلومات عن الأداة 
exe‏ ./aاMe/وS‏ التي تأتي مع الفيجوال أستوديو.ستجد التفاصيل الكاملة في مستندات ميكروسوفت ۱.50١.‏ التي تأتي مع الفيجوال أستوديو. 


1.أضف ملف /24/77 جديد .هذا الملف عملياً هو القليل من الملفات حيث تعرضه الفيجوال أستوديو كملف واحد ‏ يصف سياق بياناتك ؛×۸16٥ء‏ 4او .والفئة العامة(الرئيسية 
assاc‏ rهastص)التي‏ تحتوي كود الوصلة لكل جدول قاعدة بيانات الذي ستستخدمه في تطبيقك.لانشاء هذا الملف من مشروع الفيجوال أستوديوء استخدم القائمة مشروع أ٥‏ هزه٣۴‏ 
> > إضافة بند جديد ۴۳ا 6W‏ ١ه‏ لعرض نموذج إضافة بند جديد.من "تصنيف البيانات۲۷ه0وءاهء ها0 ".اختر قالب الفئات لينكو على سكول ا85۵ ٥ا NQ‏ اا »غير 
اسم الملف من الافتراضي إلى ا" طك. ۴4۲۷ طا .وانقر على الزر "إضافة ۸۵٩‏ ". كما في الشكل التالي. 


Add Hew Item - WindowsApplication1 


Tee: 1ً 


¥isual Studio installed templates 


XML File XML Schema 


My Templates 


1 
LINQ ta SQL classes mapped to relational objects, 


Name: Library.dbml 


يظهر اليند ١"٣طل.‏ 2٣ا‏ في مشروعك.والذي يفتح المصمم العلائقي للكائن#۲٠‏ واه 0/۸8 ءالميين في الشكل التالي.إذا تفحصت خاصياته»سترى أن اسمه 
.LibraryDataContext‏ 


30 WindowsApplication1 - Microsoft Visual Studio 


Fle Edt view Project Build Debug Data Tools Test window Help 


- چ ك 4 | e 3 -  @‏ و 


Library.dbml _Formı.vb [Design] | Start Page 


Server Explorer or Talbot aeryer Explorar 


2.أضف جداول إلى مصمم الكائن العلائقي.افتح سرفر إکسبلورر في الفیجوال استودیو(اختر القائمة عرض ۷1٥۴۷‏ > > سرفر إکسبلورر 6۲٣٥ام×٤‏ Se۷6۴۲)ستری‏ بشکل 
مسيق وصلة إلى قاعدة بيانات المكتبة في قسم اتصالات البيانات ك١‏ 0ااأء "٣ه‏ ها0 لشجرة سرفر إكسبلورر»بما أنني عملت على إنشاءها في فصول سابقة.فإنها ستدعى 
شي»ء مشابه د 0طت .sq/ex×0res5.1/b/27|اrصvصsر”.مدد‏ ذلك التفرع من الشجرةءومن تم تفرع الجداول في أسفله.جمبع الجداول في قاعدة بيانات المكتبة ستظهر. 
اسحب وأسقط جدول "النشاط رااا»A‏ " من سرفر إكسبلورر إلى النصف اليساري لمصمم الكائن العلائقي.عاجلاً آم آجلاًء ستظهر صورة الجداول على الشاشة شاهد الشكل 
التالي. 


Artivily 


Bl Properties 


Ff ID 


E Fullflarme 


3.ابني تطبيقكلقد وجدت أن هذه الخطوة ضرورية في بعض تركيبات كااهاء"الفيجوال أستوديوءولكن ليس في بعضها الآخر.فهي تعيد تنشيط عرض الفيجوال بيسك لفئات 
Library Data Context‏ الجديدة.ليناء التطبيق»اختر قائمة .Builda WindowsApplication1 ءliı< < BuiId cli‏ 

4.افتح سياق بياتك الخاصة.الكود الناتج بواسطة مصمم الكائن العلائقي يعمل على تعريف التفاعل بين برنامجك وقاعدة البيانات.ولكن يبقى عليك تعين اتصال قاعدة البيانات عندما 
تشفل تطبيقك. أضف أداة زر إلى الفورم1٣۴٠۴‏ .ومن ثم أضف الكود التالي إلى معالج حدث نقر الزر. 


Dim LibraryDB As New SqlClient.SqlConnection ("Data Source=myserver\sqlexpress;" & "Initial Catalog=Library; Integrated 
Security=true") 
Dim libraryLink = New LibraryDataContext (LibraryDB) 


اعمل علی تبدیل ۲٥/٥ی‏ رفي الکود باسم نظامك الخاصوحدث إعدادات الأمن إذا کنت تستخدم تصدیق سکول ښېرذر SQL Server authentication‏ . 
8 


الفصل السابع عشر:الاستعلام المتكامل للغة هاا Mhm76‏ 
5.كتابة الاستعلاماتءء//عاو سء أنت الآن جاهز لتصميم استعلامات لينكو.إليك الكود الذي يحصل على النشاطات الخمسة الأولى من جدول النشاط راا۷نا۸ويفرزها. 


Dim activities = HOM act IN 1librarylink . ACEIvItIeS Where act .ID <= 5 Order By act BUI Name 
For Each oneltem In activities 
MsgBox (oneIltem.ID & ": " & oneltem. Ful lIName) 
Nee One Ee 
' Messages --> 2: Manage author and name types 
' 1: Managée authors and names 
" o Manage COPY SEalUs COdesS 
'"' 4: Manage media types 
'"' 5: Manage series 


إذا نقرت الزر "أظهر جمبع الملفات"في مستكشف الحلولءتستطيع الوصول إلى الملف ا٣‏ طل. الواقع تحت ملف المصمم.۷6 ^٥۲.‏ .و/sعه.ر/م/ط/L‏ يحتوي هذا الملف على 
الفئات الوسيطة كع#ءعواء عمساهط-مو المولدة المستخدمة من قبل لينكو على سكول.طالما أننا نستخدم جدول رفي استعلامات لينكوءإليك الأجزاء ذات الصلة بالكود 
المصدري المولدة بشكل آلي: 


ESVSlEem, Data. LING: MABIN. Dalaba se RE E1 DUES NNEME SISE OEY D> | 
Partial BUbDlICG Class LIDEAarVDataCOREex 
Inherits System. Data.Linq.DataContext 
Public ReadOnly Property Activities() As System.Data.Linq. Table (Of Activity) 
Gee 


Return Me.GetTable (Of Activity) () 
End Get 
End Property 
End Class 
E Table Mame da AOC Ae EI EY J< 
Ea BEL EUOLIE CUASS NEE EY 
ا1 ع‎ e إا‎ 
Eri vaee Ul IName AS CEI 
Sê SLUMS Or age MD, BOISE SS ENGINE NOR N 
TSE imar yey NEWE) > || 
BULGE EFEOpPeEEY IDO AS HONG 


e2 
INE EE MEG __ 
End Get 
End Property 
SCS umn (SECA e> HULIName ll, 


DbType:="VarChar (50) NOT NULL", CanBENG NT: RaNSE) > |‏ 
PuUbLICG Eroperty EHuULLIName () AS SEEING‏ 
CEE‏ 
REET ME o _ BUL NENE‏ 
End Get‏ 
End Property‏ 
End Class‏ 
تنفذ الفئة 0a0 ١†e×‏ رrarطLiا‏ فئة سياق بيانات لينكو الخاصة ككهاء ا×هاهء هام NQ‏ |1 التي تبدو مشابهة للاصدار الأصغر من قاعدة بياناتي.فهي تحتوي على مراجع 
لهذه الجداول التي اخترت تضمينها في الر بط جميع جداول المكتبة ستظهر في هذه الفئة إذا كنت قد اخترتهم.لذلك»عندما أشرت إلى ء#ا۷أا۸. )راطا في عينة استعلام لينكو 
۵| ءفإنه کان یشیر إلى عضو النشاطات اانا العام من سياق البيانات. 
يعرض جدول النشاط خاصيات مميزة تتطابق مع حقول قاعدة البيانات المضمنة.لذلكءلا مفاجأة إذا ما كنت قادر على الاستعلام عن هذه الفئات من خلال لينكو تماماً مثل ما فعلت 
مع فئة النوع لينكو على كائنات.ولكن يوجد جزء غريب حول كيفية حصول الفئة على البيانات من قاعدة البيانات.وهو الجزء المخفي لینکو علی سکول ا5۵ 0 NQ‏ |1 »والمعالح 
من خلال فئة ا×ها هع ماهد القاعدية والمواصفات كا ںطنatrالمر‏ افقة مj‏ فزsl System.Data.Linq.MappingeleÎl‏ . 


عندما تبني استعلام لينكو.لا تعالج الفيجوال بيسك الاستعلام مباشرةءبالمقابل.تعمل على تأجيل التنفيذ 6/١۶5 ×٥0‏ .مشغلة الاستعلام عندما تطلب سجل من النتائج فقط 


.ويتيح لك هذا بناء استعلام من الأجزاءءوليس عليه استهلاك دورات المعالج لا۴حتى تحتاج بشكل عملي البيانات النهائية. 
WARNING: Simplistic example.‏ ' 
Dim someBooks = From bk In Library Select bk.Title, bk.Pages‏ 
Dim orderedTitles = From bk In someBooks Order By bk.Title‏ 


في هذا الكودءترتيب السجلات لايحدث حتى العيارة الثانية.ولكن هذا لا يعني شيء بما أنه لايوجد شيء تم معالجته بشكل عملي بواسطة العبارة الأولى.تذكر أن لينكو بشكل حقيقي 
يعمل فقط على تحويل استعلاماتك إلى طرق التوسيع وتعابير لامدا.الإسناد إلى s)مه8ه"هءيعمل‏ شيء مشابه للتالي: 


someBooks = Library.Select ("Title, Pages") 


.someBooks gua ةطblwçبorderedTitles أما الإسناد إلى‎ 
orderedTitles = Library.Select ("Title, Pages") .OrderBy ("Title") 


عملياً تحدث المعالجة عندما تطلب سجل من ك#5!أ۵٠٣#ل0۲.بواسطة‏ "المعالجةو”اووهع هم ".أعني أن كل طريقة توسبع يتم تنفيذها على مصدر بيانات المكتبة الأصلي 
بالترتيب»من اليسار إلى اليمين.من أجل ك5٠!٠اأ۵1٠۲٠١۲٠ءيتم‏ تخفيض بيانات المكتبة الأصلية من خلال الطريقة " اء٠اهS".ومن‏ ثم يتم تعديلها إلى حد أبعد بواسطة الطريقة 
.OrderBy‏ 


تضمين طرق يتم معالجتها من اليسار إلى اليمين تشرح لما ترتيب شروط اهمثل م5)1و ١۸ههامة‏ جدا.فالتعبير : 
LIBA. Take Z) SEIN 2)‏ 


مختلف عن التالي: 


IDE AEV. SE ONZ) Take N2) 


في النهاية سنعمل في هذا الفصل على إضافة ما يعتبر قلب نظام المكتبة:البحث م)ههاعن الكتب وبنود المكتية الأخرى من قبل الزبائن. 


عندما عملنا على بناء تموذج المكنبة الرئيسي في الفصل 7عمانا على تضمين حقول تنيج للزبون البحث عن بنود المكنبة.ولكن كان ذلك كل ما عملناه.فلم تعمل على تمكين الحقول 
ا كا ف لاام ول نض افا أك مان ا صقانت لفن الخطا ةة حل على عاب الات فة ها الل ا ف اة اني لفات 

الكت على أا فيم الى المترةغ اي 00 7622606 وال فرش داع كه ي الك فمن كه أرر ار عة الحافة الوه الو م وا لوطا عر 
رئيسية: 


تحتوي صندوق قائمة ×00اءااضخم يعرض التطابقات لفير البنود.على سبيل المثال»إنها تعرض قائمة من أسماء المؤلفين والناشرين المتطابقة كما تم البحث عنها من قبل زبون. 
عندما تظهر هذه اللوحةءيختار الزبون نموذج مطابقة القائمة ١۲٠٣٠6و”‏ اة .وينقر على الزر "بحث" لعرض البنود المرتبطة إلى المؤلف ءالناشر أو مدخلة أخرى. 


تحتوي صندوق قائمة ضخم بعرض البنود من جدول قاعدة البيانات ۳ها١م"ه..فهي‏ تعر ض قائمة ببنود المكنبة التي تطابق معيار ما.اختيار بند ما من ilãئمö Matchingliems‏ 
والنقر على الزر "بحث" يعرض تفاصيل ذلك البند . 


تحتوي على أداة عرض ويب ۲٥ء۷W٠08۲٠/والتي‏ تعرض التفاصيل حول بند مكتبة وحيد .محتوى التفاصيل يتم بناءه باستخدام 1۳1 قياسي»ويمكن أن يحتوي وصلات تعيدك 
إلى لوحة ء"ء†ااممم۴مع مجموعة جديدة من البنود المتطابقة المعروضة.على سبيل المتال»إذا كنت تعرض تفاصيل كتب الفيجوال بيسك2008 الفائزة بالجوائز ونقرت على اسم 
الناشر لذلك البند.تظهر اللوحة ك٣٠#اام"ة۴»مجدولة‏ جميع البنود المعمولة بواسطة ذلك الناشر. 

تتضمن الفورم أيضاً مجموعة من الاأزرار الرجوع(في الزاوية العلوية اليمينية) والتي تعمل مثل أزرار الرجوع في مستعرض الويب خاصتكءزر الاإغلاق يغلق هذه الفورم ويرجع 
التركيز إلى الفورم الرئيسيءوقائمة(قائمة الرجوع ١u‏ ۸6ء ه8 )تستخدم لدعم ميزة زر العودة)ء ه8 .يبين الشكل التالي الفورم مع لوحة ك" ء†اام" ج۴ الظاهرة في المقدمةءبما 
نها تظهر أهمية أكثر بقليل من اللوحتين الباقيتين. 


BESS 


اليتود 
الما الاسم 
matchingItems‏ | | 


معظم كود هذه الفورم يركز على تعبئة كل من محتوى صناديق القائمة كه×٠6ءأاوتفاصيل‏ ا۷ 1۲.هذا البحث يتم عمله على الفورم الرئيسية والذي يستدعي ضمن نموذج 
البحث هذا الطريقة ۲ء٣هه65اهاااما.بحث‏ قاعدة البيانات الفعلي عن الينود المتطابقة يحدث في الطريقة مu)مما٣١ه؟٣ه۴.والتي‏ يتم استدعاءها من قبل ٣٤2۲م6S‏ هاما .تتضمن 
الطريقة مu)مما”‏ هم۴ استعلامات لينكو التي ترحل إلى قاعدة بيانات المكتبة وتعود بواسطة الموفر لينكو على سكول.تتضمن الاستعلامات من أجل أنواع اليحث المختلفة 
التي تم تضمينها:أبحاث حسب العنوان !انا المؤلف۲ه ٣ه‏ . الموضوعاءهزطدء .الكلمة المفتاحية١١0‏ سره .الناشر ۸8۲ءاااام .السلاسلءه٣هء‏ .كود التعريف 2١‏ , 
مcod.وبعض‏ أرقام المعرفات ١#طا۳ند"‏ 0|.معظمها للاستخدام الداخلي.نوع اليبحث الذي تم عمله يحدد أي من اللوحات الثلاث سيتم عرضها(بواسطة المتغير ممر٣اuاءه».).‏ 
فبحث المؤلف يعرض اللوحة ٥1ء1ة1۷٥‏ ۴4 مع قائمة بأسماء المؤلفين الموافقةيعرض بحث العنوان البنود المتطابقة على لوحة ك٠#ااام"ة۴.قبل‏ أن نلقي نظرة على كود 
لينكوءنحتاج إلى تثبيت مجموعة من الأشياء في باقي التطبيق لدعم استعلامات لينكو الثلاث هذه.لذلك عملت على عدم تمكين الملف ط۷ .مu‏ )هه 1”/ع/ من الترجمة الآن لأن عمله 
بقدر كون لينكو على سكول مذهل .فإنه ييقى بحاجة إلى لمسة الإنسان(وهر أنت) للمساعدة على إيجاد جداول قاعدة بیانات سكول سرفر.سنعمل على استخدام مصمم الكائن 
العلائقي €^ Object Relational Desig‏ الذي عملنا معه سابقا في هذا الفصل.اختر من القائمة مشروع ۴٣٥٥٥٤‏ > > إضافة بند جدید ٣٥ا ۸d ٥۷W‏ .۔علی نموذج 
إضافة بند جديد اختر بيانات ا02 من قائمة التصنيفاتءه اام وهاه .اختر الفنات لينكو على سكول sمsعها٣‏ ا5۵ ٥ا L|NQ‏ من حقل القوالب esأھام٣۳٥٦.‏ وضع 
الاسم في حقل الاسم إلى ٣٣١‏ طهك.۷اج١‏ طا[ قبل النقر على الزر إضافة ١۸۵.وبالنقر‏ على زر إضافة تظهر نافذة المصمم الفار غة 96ء0 0/8 . 
افتح السرفر إکسبلورر ۲۴6۲٥ام×٤‏ 56۲۷6۲ واستعرض قاعدة بيانات المكتبةر/0/8// .ومن تفرع الجداول كهاطة١.اسحب‏ واسقط الجداول التالية على النصف اليساري من 
نافذة المصمم الكائن العلائقي: 
e Author‏ 
e CodeMediaType‏ 
e CodeSeries‏ 
e ltemAuthor‏ 
e ltemCopy‏ 
e ltemKeyword‏ 
e ltemSubject‏ 
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e Keyword‏ 
e Namedltem‏ 
e Publisher‏ 
e Subject‏ 
سيحلل المصمم بشكل صحبح العلاقات بين الجداول ویظهر خطوط الربط بين المراجع التانوية.تستطبع ترتيب الجداول عند الحاجة لرؤية الجداول بشكل أفضل, لنعمل على إعادة 
تسمية الجداول شيء ماءيحاول المصمم أن يكون زکي حقاً .مفیراً أي جمع لاأسم جدول موجود إلى مكافئه المفرد .(بشكل تقليدي الأسماء المفردة مفضلة عند تصميم جداول قاعدة 
البيانات).لسوء الحظ.ءلقد خرب التحويل اسم جدول ء#ا656١ه0).مغيراً‏ إياه إلى ر6S6١0٥.إنه‏ جيد.ولكن ليس له معنى.اختر ذلك الجدول وغير خاصية اسمه ١٣هل‏ إلى 
codeSeries‏ في نافذة الخصائصe)|e5مopە۴r‏ . 
يعمل ذلك 8 إعادة وضع اء اال إلى جذورھ ما یزال غير ا نا استخدمنا ن أسماء هذه الجداول لاسماء اناج او الفورمات في تطبيق المكتية. 


ترجمة الگو د وبا أنذي کسول جداً لعمل ذلك.لازالة اا إضافة ا الى کل ا کول یکو على LINQ to OL Ju‏ .في المصمم»اختر کل ا 
واعمل على تسميته من جديد» مضيفاً @ إلى بداية كل جدول بحيث مثلاً يصبج اسم الجدول ءهإهS‏ ههه بالاسم كهنامSمكهQC‏ وهكذا.عندما تنتهي فيجب أن يكون لديك عرض 
المصمم مشابه للمعروض في الشكل التالي. 


Author AItamÃuthor لھ‎ || QCadeMedaType 
3 Properties 3 Properties | 2 Properties 
FD O * TF ltemlD | Fp ٤ 
EY LastName TF EP AutharlD FF FuNN ame ل‎ 
E First ame SEQUENCE FF CheckoutD ays 
EF Middle ams EFF AuthorT ype FRR enewD aps 
E Sutin RenewT imes 
ET Birthr'ear ¥ FFD ailyFine 
Deathfear 5 x EIS IIDSIEEIISEILDISDIE IZOD 
Carmrmerits HNamedltem لھا‎ 
پ۷‎ 
a HR & Bl Properties 
ubli چ اخ‎ 
١ ّ ACodeSeries لھا‎ 
Jl Pmoperlis 0 la _ EFS ubtitle 
F FID ٣ EFPpDesciplion 0 0 0 0 O < E1 Properties 
FTP FullN ame FTE dition F EID 
ET webSite EP Publisher FF Ful ame 
Dewey 
ELL 
EFISN 
HltemCopy ھا‎ ETLCCN HltemS uhjert ھا‎ 
E Copyright 
Series 
1 Properties FF MediaType 3 Properties 
F FID FF Out fPrint TF FltemlD 
ET lternlD ک‎ : TF EF SubjectlD 
0 Copy urnber ¥ 
ا‎ Description Rj 
EF Available BHltemKemord ا‎ 
0 Missing 
ET Reference 3l Properties Subject 
Conditior F FF ltemlD 
e F FF KeymordlD El Properties 
TF ID 
f Stahus 
FFB arcode FF FullName 
| ET Location QKeş word 3 
5 Properties 
F FID 
Full ame 


على الرغم من صعوية ضمان تجنب التعارضات لجمبع الأسماء وأنها مفر دة»فعندما نستخدم بيانات المكتبة في سياق استعلامات لينكوسنجد أن جميع أسماء الفئات من أجل لينكو 
على سكول المولد لهذ الجداول قد جم «ll‏ )آي .(QPublisher je Î Q Publishers‏ 
بالرجوع إلى كود المشروع من أجل الفصل 12.فقد عملنا على إضافة طريقة توسبع إلى الفئة e2۴‏ 2۸R†ة0|وS.اnءناC‏ اك والتي تنسق اسم المؤلف من استعلام قاعدة البيانات. 


<System. Runtime.CompilerServices.Extension ()> _ 
Public Function FormatAuthorName (ByRef dbInfo As SqlClient.SqlDataReader) As String 


لسوء الحظ هذا الروتين مفيد فقط مع نت SqIData Reader‏ .في الروتين ۴erform Lookup‏ الذي سنعمل على إضافتهءنحن بحاجة إلى تنسيق أسماء المؤلفين من استعلام 
لينكو لسجلات جدول ١٥۸ا‏ ں۵4.آكاد أخمن أننا بحاجة طريقة توسيع أخرى لنوع الكائن ذاك.افتح الكود المصدري للوحدة البر مجية 68/78/4/.۷6 وأضف الطريقة الجديدة 
gall FormatAuthorName‏ . 


EOS Ee EUR E IMeE COMP TLE Se EVIE eS Exe Son OS 
BUSLLE HUNE ELON BD @aUERNOE As QAUEhNOE) AS SEEING 
حقداع سجل مولف,للفودة بالاسح المنسى‎ 
Dim authorName As String 
On Error Resume Next 
e ' 
authorName = CStr (author.LastName) 
If (author.FirstName IsNot Nothing) Then 
authorName &= ", " & author.FirstName 
If (author.MiddleName IsNot Nothing) Then authorName &= " " & author.MiddleName 
ERS WE 


UE GUEROr SUE Ex MSO MoE) Then 
authorName &= ", " & author.Suffix 
ا ات ا ا‎ 1 
TE (auEROor E1zthveat TeNol MNOERING) OF | 
(author. DeathYear IsNot Nothing) Then 
authorName &= " (" 
TF (auUENOE.BLEENYear IS NGOENInNG) Then 
authorName &= "??2?2?2" 
Else 
authorName &= CStr (Math. Abs (CInt (author.BirthYear) ) ) 
IF (author.BirthYear < 0) Then authorName &= "BC" 
ERd UE 
authorName &= "-" 
If (author.DeathYear IsNot Nothing) Then 
authorName &= CStr (Math. Abs (CInt (author. DeathYear) ) ) 
If (author.DeathYear < 0) Then authorName &= "BC" 
ERG TUE 
authorName &= ")" 
End Tf 
ف اا‎ 1 
Return authorName 
ERA EUNE EI ON 


إذا قارنت هذا الكود المصدري مع نسخة #۲لة٠8۸Rاة0|ا8S۹.ستجد‏ أن هذه النسخة أكثر وضوحاً بما أنها تشير إلى أعضاء الفئة بدل حقول قاعدة البيانات من خلال القارئ.وهذا 
من أجل تفیر ات دعم لینکو.مگن الملف ظط۷ .م۸٥٥6‏ باختیاره من مستکشف الحلول وغیر خاصية Ac†i0۸‏ dا8ui‏ من ٥۸٥ل‏ إلى ماامc0m.والآن‏ لنرجع إلى الكود في 
ذلك الملف. 

يلف الروتين up‏ )ها٣‏ ۲ه؟ه۴معظم عبارة الشرط ۴| الضخمة.مع شروط مختلفة من أجل معظم أنواع البحث المختلفة.يعالج شرط 50اع|لأخير جميع الأبحاث التي ستملا 
القائمة على لوحة الفورم ك"٠†اامم‏ ه۴ .تلك القائمة التي تظهر البنود بشكل عملي.فهي تحوي الكتير من عبارات الشرط ۴| ولكن ما هو هام هو استعلام لينكو.بدل من أن يكون فقط 
مجرد استعلام بسيطفهو استعلام معقد ينمو قليلاً قليلاً .يبدأ الاستعلام بالقواعد.وطلب الكثير من السجلات من جدول قاعدة البیانات ٣٥اا۵٥٣۳ھ'.(المتغیر ۵۲۷٥٥‏ ۲طااھو سياق 
البيانات المفتوحة من أجل قاعدة بيانات المكتبة L/b/2۲۷‏ ). 


Dim itemQuery = From ni In libraryDC.QNamedItems 
٠۷18۲١ التالي إذا طلب المستخدم بنود نوع وسيطة معينة("أظهر لي فقط الديفيدي 0۷05 المتطابقة, وليس الكتب")ءيتم تحديث الاستعلام بمحاكاة الشرط‎ 
Tf (LimitByMedia <> -1) Then 
التحديد لنوع وسيطة معينة‎ : 
itemQuery = From ni In itemQuery Where ni.MediaType = LimitByMedia 
ERO IEE 
)يضيف كلمات محددة من قبل المستخدم كمعيار:‎ ٠۷س‎ 0۲١۵ يضيط نوع اليحث أيضاً الاستعلام.على سبيل المتال.بحث الكلمة المفتاحية‎ 
N GT 
keywordSet = New Generic.List (Of String) 
keywordSet. AddRange (Split (searchText. ToUpper, ",")) 
TeemOueE vy > Hao mE UM TEeMOUSEY 
Ee E Keve s. (LOGE IS EN MI OEE VUSEAS 
Ineo ANV (KeVWOEGASeE. CORNEAS (AK, ORE YMOEG . BUL Name. TOUBBEE 
Where keySet = True Select ni 
تلك الإضافة تستخدم الاستعلام الجزني للاجمالي ضمن الاستعلام الرئيسي.الكلمة المحجوز ة ١#اوالتي هي جزء من لينكوءتعمل على إسناد استعلام جزئي أو نوع نتيجة آخر إلى‎ 
)في هذ الحالة)لذلك يمكن أن يتم الإشارة إليه في مكان آخر في الاستعلام.‎ ٠56٤ متغير مؤقت ضمن الاستعلام(‎ 
حالما یتم إضافة شر وط ۵٥٥۷۸١۷١یتم تخزین واستخدام کامل الاستعلام,‎ 
IEE MN SE EES OS CC OEM Ca 
itemQuery = From ni In itemQuery Order By ni.Title, ni.Subtitle 
بعض استعلامات لينكو في الروتين بسيطة جداءإليك الكود الذي يعمل بحث عن اسم الناشر:‎ 
E E E N 
holdText = Trim(searchText) 
iê (LOSI (MOLCUES E, E) — O) MC OLO ت‎ 
Dim publisherQuery = From pb In libraryDC.QPublishers Where pb.FullName Like holdText Order By 
pb.Ful lIName 


لا بيدو أنه مختلف عن ما نتوقعه تماما في استعلام سكول.وشيء أخر مهم وهو أن القيم الشاملة |١4۲‏ ستستخدم الحرف* بدل الرمز% في استعلام سكول القياسي.بعد معالجة 
هذا الاستعلام» يتم عمل مسح على نتائج لينكوء ونقل السجلات إلى llلقilئnة .MatchingGeneral‏ 
For Each publishlItem In publisherQuery‏ 


1 التتت اك السحلات الاعضنة اة 
If (matches >= SearchMatchLimit) Then‏ 
matches += 1‏ 
Exit HOF‏ 
End TE‏ 
ا ع 
MaeeningGener al. Teems Add Mey LISE EemDae al‏ 
publishItem.FullName, CInt (publishItem.ID)))‏ 


12 


الفصل السابع عشر:الاستعلام المتكامل للغة هاا Mhm76‏ 
matches += 1‏ 
Next publishltem‏ 
هذا مشابه لكود رأيته سابقا في فصول سابقة.فهو يحمل أداة صندوق قائمة ×180ءنابالكائنات ٠١22a‏ ٠اااءااءكل‏ منها يحتوي عرض اسم ورقم معرف من قاعدة البيانات.وهذم 
جمیل من أجل متطلبات عرض بسیط 
ولكن إذا رجعت وألقيت نظرة على الشكل السابق(شكل "نموذج البحث عن بند" م0۸٥‏ ”/6/ ).من الواضح أننا نريد شيء ما أكثر أهمية من أجل قائمة البنود المتطابقة.ذريد 
أعمدة.والأعمدة تتطلب بيانات معقولة أو ممكنة. 
لتخزين هذه البيانات سنعمل على تركيب فئة جديدةءتدعى هة "ء†اوiطع†a™.والتي‏ تعمل تماما مثل ها0 ٠†ااءİاءولكن‏ لديها حقول بيانات أكثر. 
ا 2 کک ا ا د 
Private Class MatchingItemData‏ 
Public ItemID As Integer ' NamedItem.ID‏ 
EuUbDLIE TELE AS SESIN‏ 
lol le SUE ELS AS GE SE)‏ 
Buble AUEhOE AS SEIN‏ 
Public MediaType As String‏ 
Public Call1Number As String‏ 
Publ ie Overrides EUNCeLION LOSEEIMG () AS SELEN‏ 
: جا ی ا 
TE (SuUBDETELe = A") Then‏ 


ReEUEn TICEleE € U by L1 &C RUENOE 
Else 
Relurn TIiEleE € T€ "TC SUBEILElE € €, BY 1 € AUENOE 
ERO TE 
e E E 1 
ERA Class 


بما أن هذه الفئة سيتم استخدامها لعرض البنود المتطابقة على هذه الفورم فقطءفقد جعلتها فئة تابعة ضمن فئة الفورم مu)ه‏ ها" هtاالاكبر.تعمل‏ الطريقة و١5۲1‏ على إخراج 
النص الذي يظهر في القائمة. لن نعمل على إنتاج مخرجات عمودية عملياً حتى الفصل اللاحق.أما الآنءسنعمل على عرض العنوان والمؤلف فقط 
كل من اللوحة كءe٣ءاMa|ا۴aneواللوحة‏ temsااeم۴anيتضمنان‏ الزر بحث والذي مهد لاستدعاء جديد ل مu)مماصآه؟م۴بالاعتماد‏ على البند المختار في القائمة.زر البحث 


على اللوحة يستخلص الكائن المختار من القائمةة؛ة2”ءااو” ءاه“ .ويعمل بحث جديد. 
BE vale CUS AEE EeMEOOEU DS CIE KEYAN Sender AS SYSEEM ODN CSE Ell CE AE BVSIEOME E VENE SESS) HENIlES‏ 


AcCELEemLuoSkKUp. Cl i EK 
لتحت عن كحت و اسه اجره اد‎ 1 
Dim itemID As Integer 
ES N SN E 
If (MatchingItems.SelectedIndex = -1) Then Return 
itemID = CType (MatchingItems.SelectedItem, MatchingItemData) .ItemID 
عمل بحث‎ 
lS (EE EOE LOO (UI METAOE . BEDE ESOS, CO (EOD, INS) 3 BSS) | 
Then Return 
ا‎ : 
AddLookupHistory (LookupMethods.ByDatabaseID, CStr (itemID) ) 
End Sub 


استدعاء الروتين مu)هها٣۲ه]۲ه۴ييدأً‏ بمعالجة شاملة مرةً أخرى. 


إذا كان لدينا زبون لديه وقت فراغ كبير.ويريد البحث عن كتاب "الحرب والسلحع٤2٥۶۴ "war 2۸d‏ 

.يبدأ من "البحث التمهيدي ۸١٣2٠۵5اهاذ!‏ "وينتقل إلى كود "عمل بحث م)م ماص هام۴ ".العنوان الأولي"الحرب والسلم"يعرض قائمة من العناوين المتطابقة على اللوحة 
.Panelltems‏ 

.يحدد الزبون الكتاب في هذه القائمة»وينقر زر البحت.والذي يستدعي مaلج‏ |Jحدj .ActltemLookup_Click‏ 

.معالج الحدث هذا يستدعي مرةً أخرىمں)ه ها هم۴ .وهذه المرة يعمل بحث دقيق بالاعتماد على معرف 0اقاعدة البيانات ضمن الجدول ١.2۳١”‏ . 

. تظهر تفاصيل بند على اللوحة ۳ءاام" ۴2٠٠10‏ (وسأناقش كيفية عملها فيما بعد في هذا الفصل). 

. تتضمن التفاصيل وصلة إلى الكاتب الروسي "تلستوي.ليو"مؤلف الكتاب ذو المعاناة الطويلة.عندما ينقر الزبون على هذه الوصلةءفإنها تمهد لاستدعاء أخر للروتين 

Perform Lookup‏ وهذه المرة بواسطة معرف 0| المؤلف. 

.نعود إلى اللوحة ك٠#ااام"‏ ه۴ نعرض قائمة كتب وبنود أخرى للكاتب الروسي تلستويرهاءاه۲ .على فرض أن لديه الوقت ليكتب أي شيء أخر. 

إذاً الزبون لديه الآن خبرة بلوحات البحث هذه:(1) قائمة "عامة"بالعناوين المتطابقة لاأسم "الحرب والسلم"..(2)يتم عرض "التفاصيل"لابند "الحرب والسلم" المختار»و(3) قائمة 
"بنود"كتاب المكتوية بواسطة ليو تلستويرهاءاه 16۴٠ ٣‏ .ميزة التاربخ(أو الينود الأخيرة المفتوحة)المضمنة في هذه الفورم تتيح للزبون العودة إلى أي صفحة بحث سابقةءتماماً 
مثل الميزة الموجودة في متصفح الانترنت الذي لديك. 

من الممكن أن ينتج عن بعض الأبحاث المعمولة المئثات من النتائج .فنحن لانريد تخزين جمبع المحتوى في الذاكرةءبما أنه من المحتمل أن لاينقر المستخدم أبداً على الزر "رجوع". 
بالمقابل»سنعمل على عمل ما يعمله متصفح الاتترنت تماماً:تخزين المعلومات الأقل المطلوبة لعمل استعلام مرةٌ أخرى.فمتصفح الانترنت يحتفظ فقط بالاسم وعنوان الانترنت ا8ا 
للمسارات التي تم زيارتها في قائمة "العودة".(تخزين الملفات والصور ليست جزء من ميزة التاريخ)ءتحتاج الفورم u.۷6ا00۸٥1€/”1/تخزين‏ فقط هذه القيم التي يحتاجها الروتين 
۴erforn lookup‏ لمل بحث مره أخرى:نوع البحث»ومعيار النصي أو العددي المستخدم في اليحث. 

يتم الوصول إلى تاريخ الزبون بالقاعدة "ما يدخل أخيراً يحر ج أولاً أاه-اءءا؟ ,”أ-اوها "فالصفحة الأحدث التي تم عرضهاءهي التي يريد الزبون رؤيتها أولاً عند استخدام الزر 
"رجوع"ءناقشنا التركيب"مايدخل أخيرآ يخرج أولاًء في الفصل 16:في الستاك(الذاكرة العشوائية).كل مرة يعرض المستخدم لوحة»سنعمل حاشية عليهاء عارضين فقط تلك القيم التي 
سنحتاجها فيما بعد على الستاك(الذاكرة العشوائية).عندما يريد المستخدم عرض التاريخ»سنعرض محتوى البحث الأكثر حداثة للذاكرة العشوائية ونحدث العرض. 

تخزن الفئة راهاءİ٣ up‏ )مما صهtا»‏ وهي فئة أخرى تابعة ضمن الفئة مu)هها.‏ ]اء القيم التي نحتاجها لإدارة التاريخ في الستاك)عهاء . 


اة اامقتص اركح االجردض ف حدس اضرع مده 
Private Class ItemLookupHistory‏ 


BUCO NE HIS ESEVDISSLAY AS SERIN 
Public LookupType As Library.LookupMethods 
EuUbIIE UookUpData AS SEEING 

End Class 


يوفر الحقل رهامءا۲۷2هاءن١٣‏ اسم عرض قصير لمساعدة المستخدم على عمل بحث خلال التاریخ.بینما ممر۲مu)هماو Data‏ مokup‏ اهي قیم یتم تمریرها إلى 


Lookup‏ rmد]۴erf.‏ لجعل الاشياء أفضل»سنستخدم ستاك(أو ذاكرة عشوائية) شاملة )ءهاء امهو من أجل التخزين الفعلي.وتم التصربح عنھا كحقل للفئة k)upھ‏ مہا 
Private LookupHistorySet As Collections.Generic.Stack (Of ItemLookupHistory)‏ 
كلما زار الزبون كل لوحة.تملا الاستدعاءات إلى الطريقة الستاك بكل بند تم زيارته حديثاً. 
Private Sub TET searchType As Library.LookupMethods, ByVal searchText As String)‏ 
ااضافة نبنت إل تاريخ التنحث 
Dim newHistory As ItemLookupHistory‏ 
و Dim displayText As‏ 
اء تصن حرص ف بت جد 
displayText = BuildDisplayText (searchType, searchText)‏ 
بناء بند تاريخ جديد 
newHistory = New ItemLookupHistory‏ 
newHistory.LookupType = searchType‏ 
newHistory.LookupData = searchText‏ 
newHistory.HistoryDisplay = displayText‏ 
TS EY CE Push (newHistory)‏ 
کت ا 
RefreshBackButtons ()‏ 
ENG SUS‏ 
فيما بعد عندما ينقر المستخدم على واحد من أزرار العودةءيختبر معالج حدث النقر )ءا _te”nsاMenu Back‏ تاريخ الستاكءويستدعي مup nook)‏ Perforعند‏ الحاجة.ولاننا 
عملنا على تخزين الكائنات في ستاك شاملة)ءهاء ءأ6٣‏ هو .فليس علينا تخصيص تحويلها من ء#زطا0.”ءاءرS.فالبر‏ نامج يعرف تماما ما هو نوع البيانات التي عليه. 
EE vate SUS BaGEMenu u Eems CIEE KEYAN Sender AS SvySeEem. ON eECE, BVUal @ AS SYSLEeM EVEN CAEIS)‏ 
Handles BackMenu1l.Click, BackMenu2.Click, BackMenu3.Click, BackMenu4.Click,‏ 
BackMenus.CliGK, BackMenu6o.Click, BackMenu/. Click, BackMenus. Click,‏ 
BackMenu9.Click, BackMenul0.Click‏ 
الاح تن داد هة الا ج رة 
Dim whichItem As Integer‏ 
Dim counter As Integer‏ 
Di SENE TSESE VY MS LOL OOPS‏ 
EES‏ اا ااا ج سرن 
WAR1 EMI eem > CIRE (Digits Only (Ciye (Sender,‏ 
System.Windows.Forms.ToolStripMenulItem) .Name) )‏ 
If (whichItem >= LookupHistorySet.Count) Then Return‏ 
1 اتی می اد اا و 
For counter = 1 To whichItem‏ 
LookupHistorySet . Pop ()‏ 
EE COMES‏ 
1 عمل بحث عند الطلب 
scanHistory = LookupHistorySet .Peek‏ 
If (PerformLookup (scanHistory. LOookupType, scanHistory. LookupData,‏ 
False) = False) Then Return‏ 
RefreshBackButtons ()‏ 
End Sub‏ 


تبني الدالة AndLinks|اML HM ىیوتحمBuiا dH‏ الاي يظهر على اللوحة”ءامء" ٠١10‏ ه۴ .تتضمن هذه اللوحة تفاصيل بند SingleltemDetail>ls‏ أداة مستعرض انترنت 
NebBrowserمضمنة‏ مچ الدوت نت.بشكل أساسي هي نسخة من مستعرض الانترنت ۲۴۲٥۱م×٤ |١٠۲٠ ٠۲‏ الذي تضمنه في تطبيقاتك.من الطبيعي»آن تزود لها عناوين 
الانترنت ا#لامن أجل العرضءولكن تستطبع توفير محتوى مخصص من خلال الخاصية 00u "٠۸۲١ ٠×‏ لاداة مستعرض الانترنت. طرق البحث 0اءءaطهاة0(ر8و‏ 


.BuildHTMLAndLinks jo داعملl على إسناد هذه الخاصية ضمن المحتو‎ لمعت۴erfor‎ L0) up الروتين‎ نمضByBarcode‎ 
SingleItemDetail.DocumentText = BuildHTMLAndLinks (CInt (idQuery.ToArray (0)) ) 


المحتوى الموفر بواسطة هذا الروتين هو ا1۲۷ قياسي.ولكن مع بعض الوصلات المصنوعة بشكل خاص والتي تتيج لبرنامج المكتبة عمل بحث إضافي بالا عتماد على تفاصيل 
بند المكتبة المعروض. 

معظم نص ا11 معياري» ويبدو من المخزي إشغال نفسك في عمل ضم سلاسل حرفية لتضمين هذا المحتوى.لذلك وبالمقابل» عملت على تخزين الكثير من ا1۲۷ كمصدر 
ملف نصي من خلال لوحة المصادر كعءu۲امءمR‏ لخاصيات المشر وعكءاا همهم .على تلك اللوحة»انقر على زر "إضافة مصدر ۸4١ ۸٥۴500۲٤٥٥۴‏ ".انقر على بند القائمة 
إضافة ملف نصي جدید New ۲٥×٤ ۴|٥‏ 4ه .وأدخل yإ١ه8مu)هما‏ هاا كأسم لملف النص الجديد»كما هو مبين في الشكل التالي. 
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Application ۳ Images ” 2 Add Resourze < کو‎ Remove 


Add Existing File... 


Lompile 
Add Hew String 
e Hew Image 
References 1 Add Mew Icon 


Add Hew Test File 


| Resources 


Splashlmage‏ 5 8 ا 


في نافذة محرر النص الذي يظهر.أضف محتوى ا۳۳ التالي. 
<html>‏ 
<head>‏ 
<style type="text/css">‏ 
Body { Fone tami lv: Arial; |‏ 
Bl E OTE E aE EAL MAEM EOP OPX2 MAEMO EOME OPx; FEONEISM ZE LOPES EONEEWENGHES BOGE FF‏ 
E SIE E AYE AIAN MAEM EOE OB MAFEN DOSES: Ox EOE SH ZEN LSD LONE VENGE MOF‏ 2 
B3 E OME EAM: Arial: margin EOD: OX; MAEIGIM- DOE EOM: OO; EONE SA ze: LOCC EONE vWeEIORE: MOLMaA LS‏ 
FONE S EVES: MEAG |‏ 
PD U MIEN EOD ZO Mar DOREOM: ZX Ma NE EEE LOOX EOE EAM YE Arial 7; FONE SIZES ACE |‏ 
EaBle Ml SSEderE SSIES BlaEK O Mar GIRE ES LOPS,‏ 
EM border: Sol black Ipx; BbackorOoUnd COlOE: black; COlIOL: white; uNIte Space: NOWraP; lLextl al GM:‏ 
EEE‏ 
E Sor der: SOLIS OIACKE Px, WOE SPACES DOMES |‏ 
dV SEES 1 COLO. BIUES |‏ 
</style>‏ 
</head>‏ 
SBOdyYZ>‏ 
إذا كنت تعرف ا1۲ ءستميز معظم المحتوى كسياق قالب صفحة تخطيطي(مؤلف من تنسيق تخطيط وخط Cascading S†راء She )C558()‏ مفلف.قواعده التنسيقية 
المتنوعة ستجلب شكل ومضمون خاص ومستقر علی محتوی المتصفح ۷۳W۹6۲٥۲(الذي‏ يظهر ضمن نموذج البحث عن بند..وهذا لیس كتاب حول CK55‏ »ولكن توجد بعض الكتب 
الجيدة تستطبع مراجعتها في خزانتك أو أن تبحث في الانترنت عن كتب بهذا الخصوص إذا كنت مهتم. 
تستطبع إیجاد جزء محتوی ا1۲ في مستکشف الحلول۴۲٣٥ام×ع‏ ١٥iاuاهS‏ .ضمن تفرع المصادر R50 ۲٤٥65‏ .من المحتمل أنك لاحظت أنني لم أعمل على تضمين 
إغلاق الوسم<رلهط/> والوسم <ا٣٤/>.لقد‏ عملت على إرفاق هذين الإغلاقين في الطريقةء )ہ1 Build H1 M|-A 7d1‏ .بما أن ضم السلاسل انحرفية string concatenation‏ 
مشهورة ببطئهاءاخترت استخدام الفئة "باني النص #۲هاأ8 و١٠٣5‏ "فة شبيهة بالسلسلة النصية خاصة مصممة بشكل خاص من أجل السرعة عند إضافة محتوى بشكل متكرر 
على النص القاعدي.تعمل على إرفاق المحتوى إلى نهاية "باني النص ١6ا8‏ و١٣†S"باستخدام‏ الطريقة ١١‏ ءمم4والطريقة٥١‏ ال۵٣‏ همم .وتستخلص النص الكامل من خلال 
الطريقة و١٣‏ ؟ه ٣‏ القياسية . 
سنبدأً المحتوى بنص ا1۲ المعياري المجدول سابقاً.بما أننا أضفناه كمصدر ۲۴501۷۲٥8‏ .فإنه سيظهر في الكائن كهءاهءه 1.۸8 تحت الاسم الذي منحناه إياه. 
Dim detailBody As New System.Text.StringBuilder‏ 
detailBody.Append (My.Resources.ItemLookupBody)‏ 


معظم الكود يعمل على إضافة نص سهل إلى باني النص ۷ه i|80هاههباستخدام‏ طريقته ٠‏ نال”هممA,»إليك‏ الكود الذي يضيف عنوان الكتاب الرئيسي: 
ET EST‏ 


sqlText = "SELECT Title, Subtitle FROM NamedItem WHERE ID = " & itemID 
dbInfo = CreateReader (sqlText) 

dbInfo. Read () 

detailBody.AppendLine ("<h1>" & HTMLEncode (CStr (dbInfo!Title)) & "</h1>") 


الدالة "MLE code‏ Hالمستدعاة‏ في هذا المقطع» مضمنة في الفئة مu)ه‏ ها" ه]ا.فهي تعمل بعض التعديل البسيط لحروف معينة عند الحاجة بواسطة 11M‏ .يتم استدعاءها 
بشکل متکرر .BuildHTMLAndLinks Jڵlخ j‏ 

لذلك »هذا هو الا۷ ۳۲ .ولكن ماذا بخصوص الوصلات؟إذا وضعت وصلة قياسية )٣ا‏ ۸42۲۹ اء .كالوصلة: Gp. www .mcroso/ 1 c0‏ فإن المستعرض المضمن 
سينتقل إلى الصفحة عند النقر على الوصلة.ولكن هذا لا يساعدني في عمل بحث على قاعدة البيانات.لا تعرض آداة ٥We‏ 8ط٥۷۷حدث‏ "تم نقر الوصلةd‏ مااع )ہا "بشكل 
حقيقي. ولكن لديها حدث التصفح و” اة وا2۷١‏ والذي يكون مغلق.ينطلق هذا الحدث كلما أراد المتصفح الانتقال إلى صفحة جديدة.لحسن الحظءواحدة من قيم البيانات الممر رة لمعالج 
الحدث هو عنوان الانترنت ا۸ ل المستهدف.لذلك.كل ما علينا عمله هو بناء وصلة تحتوي معلومات نحتاجها لعمل بحث قاعدة البيانات. 

قررت تخزين تفاصيل بحث قاعدة البيانات المناسبة كتجمع ١0ناءهاامت‏ (مشابه للذاكرة العشوائية للتار يخ)ء٤هاء‏ 0۲۷أكا؟ ).وأنشئت وصلات مشابهة لعناوين الانترنت 81ا 


مزيفة تشير إلى أي بند سيستخدم في التجمع. بعد الكثير من التفكير والتمعن.قررت استخدام تنسيق وصلات عناوين الانترنت ا8 لاالمزيفة: 
BEA‏ 


حیث ×یتم استبدالها بأي فهر س ضمن تجمع الوصلات ٥٣‏ ااام .فهو بسیط ویعمل بشکل جید.تجمع تفاصیل البحث هي قاموس شمولي 96۸8۲٥ di02۲۷‏ مخزن کحقل 
ضمن فئة الفورم. 


"فئة لقنص شبه الوصلات على عرض بند وحيد 
Private Class SingleltemLink‏ 
Public LinkType As Library.LookupMethods‏ 
Public LinkID As Integer‏ 
End CUaSS‏ 
Private ItemLinkSet As Collections.Generic.Dictionary (Of Integer, SingleItemLink)‏ 


ومن ثم بالعودة إلى كود بناء ال ا »عملت على إضافة عناوين انترنت كا۸ لامزيفة وكائنات ١k‏ نا" ماماو Sبشكل‏ متر ادف.إليك بعض الكود المستخدم لإضافة وصلات 
المؤلف.تقديم قارئ بيانات مع حقول اسم المؤلف.(توفر القيمة Dار٣؛٣ه‏ بدل ×في المكتبة.×//:2۷٣‏ 5نا ) 


New 


TÊ 
ERG SUS 


تخزينه في تاربخ البحث. 
ByVal‏ 


s Nothing 


E, ByYual 8 Handles MyBase 


New 


New 
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New CIEE CInt 


New 


Do Whi le 


يعمل الزر تنظيف َ لوحة البحث إعادة إعداد جميع الحقول ویحضر ها م م بحث کا معالج |لحدj ActSearchClear_Click‏ .كما يلي: 
ByVal As ect As Handlê‏ 


Ena Sub 
يما أن مشروع المكتبة من المحتمل أن يتم استخدامه من قبل العديد من الزبائن المختلفين على طول اليوم»سنفرض أن شخص أخر يستخدم البرنامج كل مرة تعود الفورم إلى لوحة‎ 
البحث.لنحاكي النقر على الزر تنظيف كلما عرض المستخدم اللوحة بحث.اعمل على إيجاد الطريقة TaskLibraryltem.وضفd الكود التالي إلى نهاية الروتين.قبل العبارة‎ 
.SearchText.Focus( ) 


مع الاهتمام قدر الامكان بأن يصيح التطبيق قريب من المستخدم»لنعمل على إضافة "نص التعليمات" إلى لوحة البحث والذي يتنوع بالاعتماد على نوع البحث المختار في القائمة 
المنسدلة.أضف معالج حدث Search اype_SelectedlndexCh ange‏ جدید ومن ثم أضف له الكود التالي: 
ByVal As Object, ByVal As Handles‏ 


الشيء الوحيد الباقي»هو عندما ينقر 


dles 


المستخدم على زر بحث»أضف معالح 
H‏ 


حدث ٥‏ نا٣_۸٥AcİSe2۲‏ ومن ثم أضف کوده کما یلي: 
al 5 1 2‏ 


1 As 


E 


Then 


Or 


Then 


Return 
End TE 
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معظم هذا الروتين يعمل على التحقق من المدخلات قبل استدعاء النموذج kup‏ ہما ۵اامن خلال الطريةة .Initiate Search‏ 


والآن اليرنامج جاهز للتشغيل.اعمل على تجريبه الأن. 


القضل الان عفر اجه المت Mhm76‏ 


وزج nllمiwخInterface.ns User‏ 
تساوي الصورة ألف كلمة-أو عدة آلاف سطر من الكود المصدريءإذا كنت تعمل على إنتاج صورة نقطية منه.كتابة كود لمعالجة الصور أعماق ألوان متنوعة»أو لرسم 
طريقة كمية متجهة متعددة الطبقات»يمكن أن يصيح كابوس هندسة الطيات(التشويهات ٣5‏ 0ناها٣هء‏ )والجبر الخطيه#6۲واه ١62٣ا‏ .مما يجعل أحدنا يتوق إلى الايام 
السابقة للكمبيوترات ذات شاشات العرض.الفئة البر مجية الا ولى التي أخدتها تستخدم ۷//18 0٤€‏ ءطابعة معتمدة على نهاية طرفية(موصل طرفي )ليس لديه شاشةء 
وتتضمن إمكانيات تصويرية ضعيفة.كانت مثالية بالنسبة لي.لا أستطيع رسم خط مباشر بأي طريقة. 
لحسن الحظ من أجل هواة الفن في كل مكانءفقد قطعت الكمييوترات شوطاً طويلاً في دائرة الرسوميات. G2/#‏ نظام الرسم القياسي للدوت نتءيتضمن ميزات رسم معقدة 
والتي ستجعل 1۵۲¡ E0 W‏ 0ييكي.وهو مبني على تقنية ويندوز أقدم"واجهة أداة الرسومce GDI)" Graphics Device |nte r]‏ )ءتتضمن آوامر لرسم خطوط 
nes‏ iا.نصوص|×e)‏ .وصور "aes‏ اثنائية البعد20.خلف +601 .ءتوفر الدوت نت أيضاً دعم لأږlصيlت‏ عرض وiıڌوj Windows Presentation‏ 
Foundation (WPF)‏ الأحدث»واجهة المستخدم الفنية rich usما iہاه١؟ه c٠‏ ونظام التقديم)العرض( lلeتعدد‏ lلilıgئط multimedia presentation system‏ 
والذي يعتمد بشكل جزئي على ا ×.تتضمن أساسيات تقديم (عرض)ويندوز ۷۴۴ العرض والتفاعل مع الميز ات التي تذهب أبعد من+ا60 .ويوجد أيضاً عدة ميزات 
+ا6Dغائية‏ عن ۴۴.على الرغم من أنني سأعطي لمحة عامة عن ۷۴۴ في هذا الفصل.معظم الفصل (وجميع كود واجهة المستخدم لمشروع المكتية )سيركز على 
GDI+‏ . 


قبل الدوت نت كان مبرمجي ويندوز يعتمدون على نظام ا60 لرسم أي شيء تقريياً على الشاشةءحتى ولو كانوا لايعرفوا بوجود ا60.بالاضافة إلى الصور النقطية 
bitmap images‏ جمبع الأدواتءاەءcont‏ .اللصاقاتءاە ط2ا .حواف النافذة۲s‏ 6 0۲ط س0كwin‏ .والأيقونات 5١۸٥ء‏ التي تظهر على الشاشة كل هذا بفضل 
ا6. كانت ا62 خطوة عملاقة للأمام من الرسوم الحرفية(الرمزية).قدمت ا62 مجموعة قاعدية من ميزات الرسم والتي منها تستطبع بصورة كامنة إخراج أي نوع من 
الصور المعقدة.ولكن لم تكن سهلة.كانت الرسوم بدائية»وكان عليك تنمي م ١اط‏ أنظمة معقدة من الجزئيات. معظم المبرمجين لم يهتموا بعمل الأشياء جميلة. لذلك 
فإنهم يحاولون تجنب تعقيدات ا0 6.ولكن في بعض الأحيان يكون عليك رسم خط أو دائرةءولم تكن هناك طريقة بخصوص ذلك. 

إن+ا62 جديدة في الدوت نت»مبنية علىا60 .وتعمل على توفير ادان الأساسية كع۷ا اام عsiط‏ ل ا6D.ولكن‏ تعمل أيضاً على تزويد بعض التجمعات الأكثر 
تعقيداً لميز ات الرسوم في دوال سهلة الاستخدام.هذه البساطة أدت إلى النهضة الأوربية ١ء٠‏ هءءأه ١٠ء‏ لميرمجي الأعمال الرسومية الأولية.انظر إلى الشكل التالي 
والذي بيين صورة كانت قد رسمت باستخدام ا0 6.ونفس الصورة الناتجة فقط بعدة أوامر سريعة في ا9ا6. 


Dl GDI+ 


يجعل نظام I+‏ Gموطنه‏ فضاء الأسماءو١iسةا0.”هاءرS‏ .ويتضمن حشود 5هل ںان امن الفئات التي تمثل كائنات الرسمكاءهزطه وہiسه۲ه‏ .السطوح 
surfaces.وميز‏ ات الزخرفة ٣٠۸۲٤‏ ۸ءiاامbصe‏ التي تعمل على تمكين عرض الرسوميات.ولكن الاأمر لايتعلق فقط بالعرض.تستقرئ +ا6G0‏ الرسوم المتجهة ٣0أcمv‏ 
والنقطية م2٠‏ على جميع سطوح المخرجات المتاحة:الر سومات النقطية كمة ٠‏ اطأو الخطية ١١ا‏ على الشاشة(متضمنة أسطح الفورم والأدوات). مخرجات تقرير 
report output‏ على الطابعةء الزخرفات(النقوشا؟؟ة9۲ )على خلفية جدار السوبر ماركت خاصتك.محتوى الصور المعدة من أجل ملف ۴۴6ل -جميعها تنتمي إلى 
نفس +ا60.جميع المقاصد تستخدم نفس طرق ء١٥٣6"‏ وكائنات اء #زطه الرسم»وتجعلها أسهل لك في استقراء كود الرسم خاصتك. 
تتضمن ميزات ال+ا60 السطوحesعsurfa‏ .حبر lلرصمinks drawing elementsauرلll رصlie. drawing‏ .illgھlıgںٽansformationsiںtr‏ . 

«تستقر ئ ال +ا60سطوح lلرسصم .System.Drawing.Graphics ةidll JIlخ jodrawing su//aces‏ 
يمثل هذا الكائن لوحة(نسيج) الرسم ۷28١ء‏ و١‏ أسه۲ك»مع مواصفات من أجل عمق الألوان والحجم(العرض والارتفاع).يمكن أن تكون اللوحة على صلة بالاعدادات 
الإقليمية لشاشة الكمبيوتر أو الشيكة المحليةء المساحة المحفوظة الداخلية من أجل المخرجات النهائية إلى الطابعة»أو لوحة رسومية عامة لمعالجة محتوى في الذاكرة قبل 
إخراجه إلى العرض أو إلى ملف.نوع أخر للسطح مع ۲ء . وهو المسار 022۸ )System.Drawing.Drawing2D.GraphicsPath)مشابه‏ للمسجل الماکروي 
recorder‏ acroصمن‏ أجل الرسوميات المتجهة ٣0ء٠۷‏ (خطه ”1ا ).الرسم المعمول ضمن مسار 2۸م يمكن أن يتم "إعادة تشغيلهكهره ام۲6 " على سطح رسم 
ءالألوان والحبر ك"¡ a٩‏ كاهاهع تظهر في نموذج الألوان ٥/0۶5‏ (قيم لون كامدة أو شبه شفافة).ألف راشي ئع٣ء./6‏ (م2١i1طالنقطية‏ المعتمدة على شبه قلم 
ensم-seudoمالمستخدم‏ من أجل التعبئة ءاا؟والاإكساء(الطلاءو ”اا (( والأقلام وعم (كائنات رسم خط ملون ãSlaçcolored line-drawing objects‏ 
معينة) 


القصل الان عفر رجه المت Mhm76‏ 


«تتضمن عناصر الرسم كأ”عمemاe‏ وinسraاط‏ المستطيلات 5او وء .القطوع الناقصة5هءم:ااه .الخطوطءه ”١ا‏ .وأشكال أخرى قياسية أو مخصصة.وهي 
تضهن انها الخطوطوكل من اة المع على الخطوط(لضوة الكاركة والمرطة اقاطالت) 

.تتيح لك التحویلات 7۲27/0٥/10۸5‏ إعادة تحجیم126ء۲ ءتدویر 8٤ه٤ه۲‏ »وحرف(تشويه ٥۷W‏ ) الرسوميات عندما تعمل على إنتاجها.عندما يتم تطبيق تحويل 
على سطح.تستطبع رسم كائنات وكأنه لم يتم تطبيق تحويل عليها وستحدث التغيرات في الوقت الحقيقي. 

أدوات نماذج ويندوز التي تستخدمها في تطبيقات سطح المكتب تحترس بشكل عام من ميزات العرض الخاصة بها.مهما يكن »بعض الأدوات تتيح لك تولي بعض أو كل 
ولات السو علو فل الال داه هة الاه ةفافش نض لى رة طفن أخل ن اه مرا كط غاد قات ای الت فلو کل 
بو ا امو ع كو ال أ في امات وة ااه ال كلوه بقن ف اا ةه الوا وة 
حامل(صاحب)الر س2۲2۷ 0/78۲ »وهو يعمل من خلال نفس كائن الرسم المعمم ءءاامةإق المستخدم من أجل الرسوميات الأخرى.سنعمل على تضمين بعض كود 
الرسم الخاص بنا في مشروع المكتبة. 

هذا الفصل لن يغطي كامل ميزات +ا60 المتاحة فهو لن يغطي أكثر من %1 منهاءحيث أن +ا60معقد وضخم»ويمكن أن تمضي سنوات وأنت تفتش ضمن كل ميزة 
صغفيرة»ولمزید من المعلومات راجع مستندات ×0 .MS‏ 


معظم الرسم في الدوت نت يحدث في سياق كائن الرسومياتاءهزطه ءءاإمةإ6 (بالنسبة لأولئك الذين على إطلاع بالتطوير السابق للاوت نت في ويندوز»هذا مشابه 
لسياق ٥٥‏ /٥2).توفر‏ كائنات الرسوميات لوحة رسم 4۷45ع والتي ترسم بها الخطوط الأشكالء الصور النقطيةمة ٠اط‏ .و مختصرات (الماكرو)الرسم المسجلة مسيقاً 
drawing macros‏ erecorded‌rام.کائنات‏ الرسومیات لاتحتوي علی سطح رسومي بنفسها.فهي موصلات (قنوات‌؟ااں‌ ۸۵٣٥ء‏ )شاملة إلى اللوحات الحقيقية. 

يوجد دائماً سطج ما خلف كائنات الرسوميات»سواء كانت جزء من الشاشة»كائن نقطي ما. أو سطح المحاكاة لصفحة مطيوعة.أي رسم يتم عمله إلى كائن الرسوميات يتأثر 
مياشرة بالسطح المضمن.يتضمن كانن الرسوميات الكثير من الطرق التي تتبح لك رسم أشكال وصور على سطح الرسوميات.وتنجز نشاطات سحرية أخرى ثنائية 
البعد20. وسنغطي العديد منها في هذا الفصل. 


إن الحصول على كائن رسومي من أجل نموذج على الشاشة أو أداة سهل بقدر سهولة استدعاء طريقة أداة النموذج .CreateGraphics‏ 
Dim wholeFormGraphics As Graphics = Me.CreateGraphics ()‏ 
Dim buttonOnlyGraphics As Graphics = Buttonl.CreateGraphics ()‏ 
بعض الأحداث»والأكثر ملاحظةً حدث الطلاء ٤٣٠۷ء‏ ا"ه۴من أجل الأدوات والنماذج.توفر إمكانية الوصول لكائن الرسوميات من خلال المعاملات النسبية 
arguments‏ allدeventj‏ . 
Eri vate SUS EICEUEeBOXL EAINE(BEYVaAlN Sender AS Oo ec, ByVal @ A9‏ 
System.Windows.Forms.PaintEventArgs) Handles PictureBoxl.Paint‏ 
Dim paintCanvas As Graphics = e.Graphics‏ 
End Sub‏ 


تستطبع أيضاً إنشاء كائن رسوميات غير متعلق بأي منطقة عرض موجودة وذلك بإرفاقه إلى شبكة نقطية م2 ٣٣ط‏ . 
Dim trueBitmap As New Bitmap (50, 50)‏ 
Dim canvas = Graphics.FromImage (trueBitmap)‏ 


تذكر »جمبع التغفير ات المعمولة على حالة sة۷٣aء‏ ستؤثر على الصورة .trueBitmap‏ 


عندما تنتهي من العمل مع كائن الغر افيك(الرسوميات)الذي عملت على إنشاءه يجب عليك التخلص منه باستدعاء الطريقة5#همء01 .(هذه القاعدة صحيحة من أجل العديد 

من كائنات +601 المختلفة).يجب .ويجب .ويجب عليك التخلص منه عندما تنهي العمل معه.فإذا لم تفعل.فقد يسبب فساد في الصورة.قضايا استخدام الذاكرة.أو حتى 

الأسوأءلذلك ومن فضلك تخلص من جميع كائنات الغر افيك تماماً. 
Canvas.Dispose ()|‏ 

إذا أنشأت كائن غرافيك ضمن حدث»ستحتاج في الحقيقة إلى التخلص منه قبل الخروج من معالج الحدث ذاك.ولا توجد ضمانة لبقاء كائن الغرافيك محقق في حدث لاحق. 

بالاضافة.إلى أنه من السهل إعادة إنشاء كائن غرافيك آخر في أي وقت. 

إذا كنت تستخدم كائن غرافيك تم تمريره لك من خلال جزء أخر من البرنامج(متل المرجع اطم ةإ6.٠‏ في معالج حدث الطلاء السابق).ليس عليك التخلص منه.كل منشئ 

مسئول عن التخلص من كائناته الخاصة به(التي يملكها). 


تتضمن الكتير من أعمال الرسوميات بدائيات الرسم:استخدام الخطوط القطوع » المستطيلات»وأشكال أخرى نظامية أو غير نظامية لتركيب العرض النهائي.وكما في الحياة 
الحقيقية ءإنك ترسم هذه اليدائيات باستخدام كائن قلمأء#زطاه ۴٠١‏ .من أجل تلك اليدائيات التي تنتج في شكل قابل للتعبئة أو شبه قابل للتعبئة»يعين كائن الفرشاة اللون أو 
النموذج للاستخدام في منطقة التعبئة تلك.يتضمن ال +ا60 العديد من الأقلام 5١٠موالفراشي‏ كهطءنط المعرفة مسيقاًء أو بإمكانك إنشاءها بشكل خاص بك. 


الأقلام هي أدوات رسم الخطوط تستخدم مع أوامر الرسم لكائن الغرافيك.القلم الأساسي لديه لون نقي(صافي)٣0اهء‏ لااهs‏ وسماكةness thick‏ . 

"قلم أحمر بعرض خمس وحدات 
Dım redPen AS New Pén(Color.Red, 5)‏ 
وكما مع كائنات الغر افيك أي قلم تعمل على إنشاءه يستخدم الكلمة المحجوزة ۷ل١يجب‏ أن يتم التخلص منه بشكل دقيق عند الانتهاء من استخدامه. 


redPen.Dispose () 


الفصل الثامن عشر:واجهة المستخدم. 


Mhm 76 


العديد من الاقلام المسبقة التعريف تم جعلها متاحة من خلال الفئة ٣s‏ ۴#.وہiسawاm.0ءاsرS»جميعها‏ مسماة بألوانهاءکما في‌۵ ۴۵۸5.۴86 إذا استخدمت واحد من هذ 


الأقلام ليس عليك التخلص منه. 


تستطيع إنشاء الكثير من الأقلام الهامة والتي تتنوع بأنماط الخطديكورات النهاية. وتنوعات اللون.الكود التالي يولد الصورة المعروضة في الشكل التالي: 
BE aE SUS ENSEUEEE OX LEANN E EYVA Sende AS CB ece, EU ELS‏ 
System.Windows.Forms. CLE BIE Ur eBOxX I BAIR‏ 


رسم بعض الخطوط الجحميلة 
Dim usePen As Pen‏ 

0 و الحا ية 
e.Graphics.Clear (Color.White)‏ 

أرسم خط أساسي بسماكة 1بكسل يستخدم لون شريط العنوان 
usePen = New Pen (SystemColors.ActiveCaption, 1)‏ 
e.Graphics.DrawLine (usePen, 10, 10, 200, 10)‏ 
usePen.Dispose ()‏ 

1 اام ا و ا اك م س اكان اا ا ت ل م ا ار و و 
usePen = New Pen (Color.FromName ("Red"), 5)‏ 
usePen.DashCap = Drawing2D.DashCap.Triangle‏ 
usePen.StartCap = Drawing2D.LineCap.ArrowAnchor‏ 
usePen.EndCap = Drawing2D.LineCap. RoundAnchor‏ 
usePen.DashStyle = Drawing2D.DashStyle.Dash‏ 
e.Graphics.DrawLine (usePen, 10, 30, 200, 30)‏ 
usePen.Dispose ()‏ 

1 عل اسرد مت فت م حط ات جرا ,انان ونان ر اجه مت 
usePen = New Pen (Color.FromArgb(128, 0, 0, 0), 10)‏ 
USEeEReN E OMPOUNGAT ray U‏ 
New Simo e (0) (OO, O OA TOS, OS, oO‏ 
GEaPRIECS.DEawLinNe (uUSeEEN, LO, 59, 200, 55)‏ € 
usePen.Dispose ()‏ 

End SUS 


Form Ee 


يبين الكود أن هناك عدة طرق مختلفة لتعين اللونءإما بواسطة الاسم المعرف مسبقاً Color. Whe)‏ وSystemColors.ActiveCaption‏ ).و کاسم نصي(باستخدام 
FromName‏ .ا0 ).أو بواسطة قيم حروفه الأحمر -الأخضر-الأزرق ue‏ ا8- Alpha-Red-6G re‏ (bوor.۴romArاco).‏ تلك النسخة الأخيرة تتیح لك تزوید قیم 
متميزة alpha blend "J‏ "(والتي تعمل علی وضع مستوی الشفافيةءمن 0من أجل شفافية كاملة إلى255كامد بالکامل(عدم شفافية)) الأحمر.الأخضر والأزرق هي 


المكونات بالنسبة لكامل الألوان. 


معظم الخاصيات المعينة لقلم والتي وضحتها هنا نوعاً ما واضحة وتشرح نفسها.وكما مع معظم ال+اG0‏ . كمية الميزات المتاحة والتي تخدر العقل تجعل من المستحيل 


توثيقها كاملاً في فصل واحد صغير»بكل بساطة سأحيلك إلى مستندات النت من أجل فة 


القلم ٠۸‏ للحصول على التفاصيل الير اقة. 


تستخدم ألفراشي من أجل ملئ الفراغات بين خطوط مرسومة»حتى لو جعلت تلك الخطوط بالكامل غير مرئية.تتضمن ال +ا60تشكيلة لأنواع ألفراشيءمن ضمنها 
ألفر اشي الجامدة( النقية5ه٣كن۲ط‏ هاامء )(فرشاتك الأساسية الوحيدة اللون).فراشي التظليل عوط ۸21۸ (فراشي نموذج والتي تكون ممتعة ولكنها عامة)ء 
الفراشي البنيوية كهطون۲ط هإںا×ه) (حيث يتم استخدام نمط نقطي مه١"‏ امن أجل الفرشاة).وفراشي متدر جةكهاكںءط مالةو (والتي تخفت 40 هآببطء من 
لون واحد إلى أخر عبر(على طول) الفرشاة).تتضمن الفئة كمطءںآ8.و"سه0۲.ه1ءرS‏ بعض ألفراشي الصافية(الصلبة) المعرفة مسبقاً والمعتمدة على اسم اللون.وكما 


مع الأقلام»عليك التخلص من الفراشي التي قمت بإنشائهاءوليست تلك الفراشي الصلبة | 


يرسم المقطع التالي من الكود بعض المستطيلات البسيطة بتشكيلات من أنماط الفراشي. 
ject, ByVal e As‏ 


لمعرفة مسبقاً من قبل النظام. 
وتظهر النتيجة في الشكل التالي. 


Bava te US EEE UEeBOSL EalnNE(EVUal Sender AS OD 


System.Windows.Forms.PaintEventArgs) Handles PictureBoxl.Paint 


: رسم بعض المستطيلات 
Dim useBrush As Brush‏ 
e.Graphics.Clear (Color.White)‏ 


رسم مستطيل ملون بلون صافي 


الجميلة 


€. GEaPRI CS EI LIReCEanG Le (BEUSNeS Cyan, LO, TO, T50, 50) 
رشع مستطبل مطلل . اسشتجدح السود من اجل احلفبة ,والاييض من واحهة النمودج.‎ 1 
USseBEUSM > New DrawuIng2D. HAECRBEUSM( | 


BEng ZB. Hateno ey lle Har ECORI 
COLO NRE, COLOE  BlaEKE) 


Mhm 76 الفصل الثامن عشر:واجهة المستخدم.‎ 
€. GEaBRNICS .HALIRECEANG LE (USEBEUSH, LO, 70, 150, 50) 
useBrush.Dispose () 
رسم مستطيل بشكل خطي من اليسار إلى اليمين‎ 
ا ر ا لے ال کے اال اف‎ E E 0 1 
useBrush = New Drawing2D.LinearGradientBrush (New Rectangle (200, 10, 75, 25), Color.Blue, 
Color.Yellow, Drawing2D.LinearGradientMode.Horizontal) 
e. GEaPhMI ES. HEIL IRectano le (uSseBTLUSR, 200, TO, TSO, 50) 
useBrush.Dispose () 
استخدم رة من ال افر اة‎ 
useBrush = New TextureBrush (Image. FromFile ("C:\LookupItem. bmp") ) 
€. Graphics .FIlIRectanole (uSeBruSh, 200, O, 150, 50) 
useBrush.Dispose () 
e 0 


EE EFormî1 8 E) x) 


الدوائر والمريعات رائعة.ولكنها في الكثير من الأحيان لا تكون على اتصال دائم.معظمنا يعتمد على نص لنقول ما نعني.لحسن الحظءال+ا6G0‏ لديها ميزات بوفرة تعمل 
على وضع نص على سطح الغرافيك(الرسوميات) خاصتك. كل الفضب قبل واجهات المستخدم الرسومية كان منصب على أن النصوص لم تكن القضية الحقيقية.فإما أنك 
تستخدم الرموز (الحروف)المبنية ضمن النظام أو لاتستخدم شيء. على الشاشة تم تصميم كل حرف من الاأبجدية ضمن مكون صلب لاكمبيوتر (هارد وير)أو العارض 
"0nito٣‏ وأي حرف خاص يمكن أن يظهر فقط ضمن مربع من شبكة معرفة مسبقا80 × 24 .كانت الطابعات أفضل قليلاءبما أنك تستطبع التراجع خطوة للوراء وتعيد 
الكتابة(الطباعة) على مواضع مكتوبة(مطبوعة)سابقاً لإنتاج إما نص بخط غامق أو نص بشحطة منخفضة.ومع ذلك.كنت بشكل عام مقيد بخط واحد فقط أو بمقدار ضئيل 
من الخطوط الأساسية المغلفة في ذاكرة الطابعة فقط . 
مثل هذه القيود أصبحت أشياء من الماضي.جمبع النصوص في ميكروسوفت ويندوز تظهر بشكل لائق من الخطوط رسومات لأشكال الحروف والتي يمكن إعادة 
تحجيمهاء أو تمديدها أو تأكيدها ۵4٥zاعة٣م”#لتلاقي‏ احتياجات أي نص.ولأن بإمكان المستخدم إضافة خطوط إلى النظام في أي وقت.ومن أي مصدر آخرءفإن تشكيلة 
هذه الخطوط تصبح مدهشة.ولكنك تعلم سابقاً كل هذاءلذلك دعنا ندخل إلى الكود. 
للحصول على إمكانية الوصول إلى خط ما من أجل استخدامه في رسومياتك. أنشئ حالة من الفثة ١.0۲4W 1١9.۴٥۸۲‏ ٠5ر8‏ ومرر لها على الأقل اسم خط »وحجم النقطة» 
وبشكل اختياري مرجع التخطيط 
Dim Sas TEeEEODNE AS NEV EOE (Aral, UA, EODESE VUE MEAL)‏ 
من الطبيعي. أن تتنوع قائمة الخطوط المتاحة بتنوع النظامءإذا كنت ذاهب لاستخدام خطوط أبعد من تلك الخطوط الأساسية المثبتة مع ويندوز»عليك تأكيد أن الخط المسمى 
متاح حقاًولديه خيار تراجعي إذا لم يكن كذلك.تستطيع الحصول على قائمة بجمبع الخطوط بطلبها من +601 بشكل جميل.جميع الخطوط تظهر في "عانلاتءهاأا ٣ه‏ 
"»حيث أن كل عائلة مسماة يمكن أن يكون لديها غامق١اهط‏ ءمائل اها .وتنوعات 0٠١5‏ ااة ا۷2 أخرى مثبتة كملفات خط منفصلة.الكود التالي يضيف قائمة بجميع 
عائلات الخطوط إلى أداة صندوق قائمة×180ءاا : 
Dim allFonts As New Drawing.Text.InstalledFontCollection ()‏ 
For Each oneFamily As Drawing.FontFamily In allFonts.Families‏ 
ListBoxl.Items.Add (oneFamily.Name)‏ 
Next oneFamily‏ 
إذا كان الخط الذي تحتاجه غير متاح ولست متأكد من ما ستستخدم.دع +ا60يختار لك.فهو يتضمن عدة خطوط شاملة للاستخدام الطارئ: 
Drawing.FontFamily.GenericMonospace‏ 
Drawing.FontFamily.GenericSansSerif‏ 
Drawing.FontFamily.GenericSerif‏ 
بالعودة إلى الخطوط المستخدمة فعلياً في الرسمءيتضمن كائن الغر افيك الطريقة وس0۲4 والتي تضع بعض النصوص في اللوحة: 
Eri vatê SUS EleEUreBOXL EHAINE(BVVIlL Sender AS Oo ecel, BVI @ AS‏ 
System.Windows.Forms.PaintEventArgs) Handles PictureBoxl1.Paint‏ 
Dim basicEOontê AS New HOneE( Arial’, 14, HoneEsEvyle. lEali €)‏ 
è# اذa'",‎ basicFont, Brushes.Black, 0, 0)‏ ۈرد l!خzتبlر"( e.Graphics. DrawString‏ 


basicFont.Dispose() 
End Sub 


ا ن و ا ال Mhm76‏ 

بيين الشكل التالي مخرجات هذا الكود.في معظم عينات الكود لهذا الفصل»سأعمل على إخراج المحتوى إلى أداة صندوق صورةö PictureBox1 ölowoPicture8ox‏ 

والتي عملت على وضعها على الفورم لتطبيق نماذج ويندوز جديد.وعملت على وضع خاصية هذه الأداة eارerStلإ٠8إJلى‏ FixedSingle«وخlصيةã‏ BackColor|لal‏ 

أبيض هاا /۷بحيث أستطيع إظهار ٥zاةاءا۷حواف‏ ءهو١ءاللوحة.يحدث‏ الرسم في معالج حدث التلوين؛١iه۴‏ . والذي يتم استدعاءه عندما يحتاج صندوق القائمة 
لإعادة تنشيط عندما تحجيه نافذة أخرى وبالتالي لايظهر .في باقي أمثلة الكود.لن أعمل على تضمين تعريف الروتين ٤١أة80×1_۴ءءں†ا۴‏ طااSءما‏ سأبينه لك هو فقط 
الكود الذي يظهر داخل هذا الروتين. 


El Form ا ا‎ 


بالطبع ءتستطيع مزج ومطابقة الخطوط على لوحة مخرجات مفر دة.يتضمن هذا الكود نص يستخدم 14 |اAriaو‏ 18 :Arial‏ 

Dim basicFont As New Font ("Arial", 14) 

DIM SEEORNSTEONE AS NeW EONE (LArFIaAlLL, LUG, BONESEVLE BOL) 

Dim offset As Single = 0.0 

Dim showText As String 

Dim textSize As Drawing.SizeF 

MOISE = M0 mo 

textSize = e.Graphics.MeasureString (showText, basicFont) 

€ GEaPRI eS. DEawo Er Ing ( SROMLEXE 7 Basi CHON, |1 

BEUSHeS. BLACK, GEESE, 0) 

offset += textSize.Width 

Show lexl > nn 

textSize = e.Graphics.MeasureString (showText, strongFont) 

E. GEAPRIES DEAS EE INI (SROMLEX E, SEONG EONE, 

Brushes.Black, OEFSet, 0) 

offset += textSize.Width 

SONE = E Ec NOE 

textSize = e.Graphics.MeasureString (showText, basicFont) 

E GEAR GS. DE awo Er Ing (SROMLExXE, Sasi CHON | 

Brushes. Blak, SEFSeE, O0) 

offset += textSize.Width 

SET ORNS HONE DIS OOSE (J) 

basicFont. Dispose () 


تظهر مخرجات هذا الكود في الشكل التاليءوذلك في الصندوق العلويءولكن إني أريد الحواف الدنيا لأجزاء الجسد الرئيسية بالنسبة لكل مقطع نص- بالخطوط الأساسية 
لكل مقطع-مرصوفة بشكل لائق»كما هو مبين في الصندوق السفلي. 


ENE Form1 HE 
هذا نوعا ما مقطع .تص‎ 


عمل جمبع أشياء ترصيف خط الأسطر المحبية هو نوع من الإزعاج .عليك عمل جميع أنواع القياسات بالاعتماد على تصميم الخط الأصلي كما يستقرء d#أهاممما)xم‏ 
في البكسل بالاعتماد على جهاز الشاشةءءا۷هك ١۴6٠۲ءء‏ dعءهط-ام×ام‏ .ومن تم تعمل على وصل عظم الركبة إلى عظم الفخذ, وهكذاء إليك الكود الذي يعمل على 
إنتاج الصورة الثانية للسطر المرصف. 
Eri va tê UD EIEEUEeBOX A HaNME( EVAN Sender AS O ee, BNN @ AS‏ 
System.Windows.Forms.PaintEventArgs) Handles PictureBox2.Paint‏ 
Dim basicFont As New Font ("Arial", 14)‏ 
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Mhm76 الفصل الثامن عشر:واجهة المستخدم.‎ 
Dim SW 
Dim 
Dim 
Dim 
Dim 
DIM 
Dim 
Dim 


End 0‏ 
تجري حسابات أكثر في الكود.. وأنا لم أحاول حتى معالجة #ا)ءها الأشياء مثل سد الفراغات بين الأحرفو”٣‏ ا١٣٠‏ »ربط الحروفكه۲ ناهوا .أو أي شيء أخر يجب 
ع عا الات الان غ لي ا 6 اكك الى فو اة مو اال +66 عان قر خف الفال تة وط علا ی که هو 
اط اراج بط ره م ف را ك ا ی ا و ی ا مط وو 


كفو الان اغا فة ك اسا ية ونارة على الى هكن فليا على انض أنه اال اظ أن كتركاذ اللضى كك افر في لفن الق وف سي ك 
بإمكانك رسم النص باستخدام أي فرشاة تستطبع إنشاءها. ومقطع الكود التالي يستخدم فرشاة صورة نقطية ٠٤ط‏ للصورة ۳٠٤ا‏ )هما لمشروع المكنبة لعرض نص 
ما معتمد على صورة نقطية م2٠٠‏ اط.ستظهر المخرجات في الشكل الذي يلي الكود مياشرة. 


New 


القضل الان عفر براه الت Mhm76‏ 


Form 


إندماج النص والرسوميات. 


من المحتمل وأكثر من آي شيء أخرءآن الانترنت قد أججت معدل حاجة مستخدمي الكمبيوتر للمحفزات البصرية .فمواقع الويب مغمورة ب الجيف» »وتشكيلة من تنسيقات 
الصور الأخرى.حتى لو كنت تتعامل مع تطبيقات غير الويب»من المحتمل أنك»وكمبر مج»يحدث لان تحتكٌ وعلى نحو متكرر مع صور رسومية.لحسن الحظءيتضمن ال 
+ا60ميزات تتبح لك إدارة ومعالجة هذه الصور بشكل سهل. 

تنسيق الملف" 81۴ "هو التنسيق للصورة النقطية الأُولي(الأصلي) أة١٣۲١ه؟‏ مة "1اط م۷أه" المضمن في ويندوز ميكر وسوفت.ولكنه ليس بتلك الأهمية في عالم 
الويب.ولكن ولا شيء من هذا يشكل مشكلة بالنسبة ل +ا60.فيمكن تحميل وإدارة الملفات باستخدام تنسيقات الرسوميات(الغر افيك) التالية: 

.ملفات صور نقطية" 8۴ "للويندوز بأي عمق للون وبأي حجم. 

.ملفات التنسيق التبادلي للرسومات الخاصة (لخدمة الکمبیوتر CompuServe Graphics |nterchn ange ۴٥۲٣٣2)‏ ."'الجیف 6|۴ ". تستخدم بشکل شائع من 
أجل الصور الغير فوتوغر افية(تصويرية) على الانترنت. 

.ملفات مجموعة الخبراء الفوتوغر افية المترابطة مupتإG‏ sاerمEx Photographic‏ intەل‏ »شائعة الاستخدام من أجل الصور الضوئية كهاه٣م‏ والصور 
mages‏ iالأخرى‏ على الانترنت.ملفات ۴۴6ل تكون مضغفوطة داخلياً رااة٣#۲١¡‏ ١55#١۲مn٠هء‏ لتخفيض حجم الملف»ولكن مع احتمال فقدان نوعية الصورة. 
.ملفات ملف الصورة القابلة للاستبدال(”E×۱۴“)‏ ٥ا۴ Exchangeable Image‏ .تنوع عن ۴۴6ل والتي تخزن صور فوتوغر افية(تصويريةSمa pho t09‏ ( 
اأحترافية. 

«ملفات الرسوم الشبكية القابلة للنقل(المحمولة(”6 Network Graphics )“ PN‏ eاPortab‏ ).والتي هي مشابهة لملفات 61۴.ولكن مع بعض الميزات المحسنة. 


.ملفات تنسیق ملف صوري رقعي(تجميعي).(”۲۱۴۴“) ۴0۲2 ٥ا۴ |٣29‏ و۲ والتي هي نوع من ضم (دمج) جميع تنسيقات الملفات الأخرى.بعض 
التنظيمات(المنظمات) الحكومية تخزن الصور الممسوحة(المدققة) باستخدام ۲۱۴۴. 


.ملفات توصيفيه5ه|ا؟ةN6‏ .والتي تخزن مبادئ خط الكمية المتجهة 2۲١‏ ١٣ا‏ ٣هاء‏ ه۷ بدلاً من الصور النقطية. 


«ملفات الأيقونة (كها؟ (۱۳07“) ١١٠٠|)ءوالتي‏ يتم استخدامها من أجل أيقونات ميكر وسوفت ويندوز القياسية.تستطبع تحميلها كصور نقطيةكم ةط .ولكن يوجد أيضاً 
ا اا اة لك ااا بط اة أك ل كرات 
ثلاث فئات رئيسية يتم استخدامها من أجل الصور:الصورة هوه" ا(فئة قاعدية مجردة من أجل كل من الفئتين الأخريين).. النقطية مة ٣٠ا8‏ وملف التوصيف !اه6" . 
انش فة المتافايل قفا بعد 
تمثل البيتماب 5م2١81‏ (الصور النقطية) صورة #وه ٣‏ مثلما تم رسمها على شبكة من البتات(الوحدات التخزينية).عندما يكون بت على شبكة فعال٠‏ .فإن خلية 
الغبك الك كن وة أو تة وغذها ركذن ابت فطل ۴ة فان اة الك كرون غير مرة أو قارع فين الفكل التالى ضورة ضرطة ياست الهكة 
النقطية(شبكة البتات). 


اللون الأسود والاأبيض.لتضمين ألوان أكثر تضيف الصور النقطية sم "٣2‏ ااطمستويات أو سطوح 5٠٠هام‏ إضافية .یتم تنضید ۵٥ء‏ هاءالمستويات 85هام فوق 
بعضها البعض لذلك فإن خلية في مستوى واحد تتطابق مع تلك الخلية التي بنفس الموضع في جمبع المستويات الأخرى.فمجموعة من 8مستويات تنتج في "صورة نقطية 
ب8 بتeوة bitmap i”‏ itط-8‏ ".وتدعم 256 لون في كل خلية(لأن 2“ =2 ۶= 256). تتضمن بعض الصور بحدود 32 أو حتی64 بت 5اط (مستوی 
esہهام).وأيضاً‏ بعض من هذه المستويات(البتات) يمكن أن يتم حجزها من أجل" مزبج(أشعة ) ألفاوہiك١هاط‏ هماج "والتي تجعل ملاحظة(إدر اكل ع۷أم۲c‏ مم ( 
الشفافية ٥ ۸٤٥¥‏ 2م4۸5 أممكنة. 


الفصل الثامن عشر:واجهة المستخدم. Mhm76‏ 
إن معالجة كل هذه البتات واجب مزعج.لحسن الحظء ليس عليك القلق بالنسبة لهاءيما أنه يتم عمل كل هذا لك بواسطة الفئة مة١81.تحتاج‏ فقط إلى تحميل وحفظ الصور 
النقطية( باستخدام طرق الصورة النقطية م٣8‏ اليسيطة.بالطبع)ء استخدام البتماب كفرشاة نأو كائن رسم وأسه۲ل (كما فعلنا في بعض أمثلة الكود في هذا 
الفصل سابقاً)» أو الكتابة على نفس سطح صورة نقطية بإرفاق كائن غرافيك sءأ۸مة6لها.‏ 
إذا كان لديك صورة نقطية في ملف.تستطبع تحميلها بواسطة مشيد فة البتمابمة »)ا8 : 
Dim niceImage As New Bitmap ("c:\LookupItem. bmp")‏ 
لحفظ كائن الصورة النقطية إلى ملف»استخدم طريقتها 52۷0. 
niceImage.Save ("LookupItem. jpg", Imaging. ImageFormat. Jpeg)‏ 
مشيد أخر يتبح لك إنشاء صور نقطية جديدة في بتنسيقات متنوعة. 
SE A ES SU U ES a‏ 
الكل دن الام بالغ دالرن 8 لل ل 
N E CO O OB EET‏ 
Dim nicelmage As New Bitmap (50, 50, Drawing. Imaging. PixelFormat. Format32bppArgb)‏ 
لرسم صورة على سطح رسومي(غر افيك)ء استخدم الطريقة موة "!سه0 لكائن الغرافيكءء¡٣مaاG‏ . 
e.Graphics. DrawImage (niceImage, leftOffset, topOffset)‏ 
تلك العبارة ترسم صورة إلى سطح غرافيك كما هوءولكنه نوع من الملل.تستطبع تمديد الصورة وتحصل على الصورة كما رسمتهاء أو حتى إنتاج صورة صغيرة 
„thumbnail‏ 
سأجرب جميع هذه الطرق باستخدام صورة من مشر وع المكتية(الصور ة 09 )50/25۸//٣29€‏ 
Dim splashImage As New Bitmap ("SplashImage.jpg")‏ 
ارسمها بنصف العرض والارتفاع 
e.Graphics.DrawImage (splashImage, New RectangleF (10, 50, splashImage.Width / 2,‏ 
splashImage.Height / 2))‏ 
: مددها 
e.Graphics.DrawImage (splashImage, New RectanglerF (200, 10, splashImage.Width * 1.25,‏ 
splashImage.Height / 4))‏ 
1 اا او ا 
e.Graphics.DrawImage (splashImage, 200, 100, New RectangleF (0, splashImage.Height / 3,‏ 
splashImage.Width, splashImage.Height / 2), GraphicsUnit.Pixel)‏ 
يبين الشكل التالي مخرجات المقطع السابق من الكود.ولكن هذا ليس كل الرسم الذي تستطيع عمله.تتضمن الطريقة #وة 04W!"‏ 30 إعادة تعريفءل4 0۷6۲|٠١‏ .وذلك 


سبيقيني مشغول 37 دقيقة على الأقل. 


Form 


لقد غطينا معظم الميزات الأساسية لل +601 المستخدمة لرسم الصور.والآن كل مافي الأمر إصدار أوامر الرسم من أجل الأشكالءهمة ٠ء‏ .الصور 
inages.والنصوص‏ ×6اعلى سطح غر افيكءءاامه۲و . معظم الوقت الذي ستمضيه مع الطرق المضمنة في كائن الغرافيك»يوجد القليل من الطرق الهامةءإليك 
عینات منها: 

.طريقة التنظيف62۲٠!ا٥‏ .تنظف الخلفية بلون معين. 

.الطريقة S۵٢‏ ٣۴رمه.إذا‏ أسقط (غير موجود)مفتاح"تصوير الشاشة١۲٥5 ۴۴٣۲‏ " على لوحة مفاتيحك»هذه هي الطريقة التي تحتاجها. 
.الطريقة٠١٣W۸ه0‏ .رسم جزء من قوس على طول الحافة للقطع الناقص.نقطة الصفر تبدأً عند الساعة الثالثة.قيم المسح للقوس الموجب تتحرك باتجاه عقارب الساعة 
هkwisعoاc.‏ واستخدم قيم المسح السالبة للتحرك بعککس laeرب‏ lıllعة counterclockwise‏ . 
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اقل اكان عقر و اة ا Mhm76‏ 

. الطرق zie .و0rعw8 i6۲‏ rawBeط‏ ترسم منحنيات بيزيه» معادلة معتمدة على منحني يستخدم مجموعة من النقاطء ز اند مواجهات تقود المنحني خلال النقاط 
.الطرق DrawCurve‏ و Draw Closed Curve‏ وsedCurve‏ ۴ .ترسم المنحنيات الرئيسيةا2٠ ٥4۲١‏ (حيث تحدد النقاط مسار المنحني)ءمع فرشاة ملئ اختيارية. 
.الطرق raw ٤ام se‏ Dو‏ i|pseاا۴E.تر‏ سم قطع ناقص أو دائرة(والتي هي تنوع عن القطع الناقص). 

.llطرJ DrawlmageUnscaled And Clipped DrawlmageUnscaled.Drawlmage «DrawlconUnstretched «Drawlcon‏ .طرق مختافة لرسم صور 
.الطرق e‏ سهاو rawi nes‏ .ترسم خط أو أكثر مع الكثير من الخيارات لجعل الخطوط جذابة/822١5‏ . 

.الطرق Draw P٢‏ و ۴۴th‏ .سأناقش"مسارات الفر افيك"بعد قليل. 

.الطرق ١ا۴ ۲4W‏ وه۴|١¡۴‏ .ترسم حدود شريحة على طول حافة قطع ناقص. 

.الطرق ەوراە5raw۴و‏ ”وراه ۴|١۴.ترسم‏ أشكال هندسية نظامية أو غير نظامية بالاعتماد على مجموعة من النقاط 

. rectanglesتIıطbiwogsquares‎ ٽl2ıرe‎ pw رi.Fill‎ Rectangles ۾‎ FillRectangle .DrawRectangles .DrawRectangle .طرق‎ 

.الطريقة و١اWS۲سه0۲.نستخدم‏ هذه الطريقة قبل إخراج نص إلى لوحة. 

.الطريقة ١هوه۸8١ذ۴.سأناقش‏ القطاعات ١٥و۲‏ فيما بعد في هذا الفصل. 

ليك عينة كود رسم : 


40, AOI < OS E e 
e.Graphics.DrawLine (Pens.Black, 10, 10, 40, 40) 
ان د 00 ت راان ارت الاتاعة من ال دانرة تر 0ه و‎ | 
2 CEE ACE , DESMA Ee (EERE ELEK, SO, 10, 40, 20, U, 0) 
مستطيل 40×40 معبئ بخط مقطع‎ 
e.Graphics.FillRectangle (Brushes.Honeydew, 120, 10, 40, 40) 
Using dashedPen As New Pen (Color.Black, 2) 
dashedPen.DashStyle = Drawing2D.DashStyle.Dash 
e.Graphics. DrawRectangle (dashedPen, 120, 10, 40, 40) 
ل‎ 5 
شريحة من مقطع بيضوي‎ 
E. EERIE E . ALLELE (ECUSRES “EE IMO, 1S0, 10, 20, 40, 180, 1207 
وهكذاءلقد أخذت فكرة.بيين الشكل التالي مخرجات هذا الكود.‎ 


EE Form 


تتبح لك فئة ۸ة ۴ءءا۸مةإ6تجمبع الكثير من كائنات الرسم البدائية(متل الخطوط والأقواس وحتى المستطيلات)في وحدة تجميعية مفردة.هذا المسار الكامل يمكن أن يتم 
إعادة تشغيله ضمن سطح غرافيك کجامع(شامله۲ "2٥‏ ). 
Using thePath As New Drawing2D.GraphicsPath‏ 
thePath.AddEllipse (O0, 0, 50, 50)‏ 
EMEA. ACOAEE NL, 30, 30, 10, 10, 160)‏ 
thePath.AddRectangle (New Rectangle (15, 15, 5, 5))‏ 
thePath.AddRectangle (New Rectangle (30, 15, 5, 5))‏ 
e.Graphics.DrawPath (Pens.Black, thePath)‏ 


Ad USI 
Cc Te 
HE Formı1 آ3 کک اک‎ 


لحسن الحظ توجد استخدامات أخرى لمسارات الفرافيكبعض منها سأناقشه في المقطع اللاحق. 


الفصل الثامن عشر :واجهة المستخدم. Mhm76‏ 

غ وع س هقان لوك كاف الوك الم فى آل أل طا وط ع آل وا ها ج هة آل ا ارون ف ع اقات ن 
أن يظهر فقط جزء من ما ترسم .يستخدم ويندوز هذه الطريقة بنفسه لحفظ الوقت.عندما تحجب نافدذة بأخرى ومن ثم تعرض النافذة المخفيةء على التطبيق أن يعيد رسم كل 
شيء يظهر على النافذة أو الفورم. ولكن لو كان قسم من خلفية تلك النافذة مخفي ومن تم تم جعلتها مرئية مرةٌ أخرى.فلما على البرنامج أن يذهب خلال مشاكل رسم كل 
شيء مرةً أخرى؟في الحقيقة عليه أن يعيد رسم فقط الجزء الذي كان غير مرنيءالجزء الذي كان مخفي في القطاع. 

نن الفطاع 6667 ساكة ن أكل الرس على فطع ما وااقطاعات عر مكح باأغكل الفنوطت طن تة قطاع بالا غاد عاي أل هة او اة 
دمج قطاعات موجودة في قطاعات أكثر تعقيدآ.على سبيل المثالءإذا كان لديك قطاعين مستطیلينتستطبع تشبیكهم وتستحضر قطاع موحد جدید يحتوي على (1) کل 
القطاعين الأصلبين.(2) القطاعات الأصلية ولكن بدون الأجزاء المتداخلة. (3)فقط الأجزاء المتداخلة.بيين الشكل التالي هذا الضم. 


al 4 £ 


Original regions Union Kor (XOR) Intersect (AND) 


خلال عملية الرسمحءيتم الإشارة في بعض الاحيان إلى القطاعات ك"قطاعات قص ك٣‏ ه٥اوه۲‏ وام مااع "لان أي محتوى مرسوم خارج القطاع يتم قصه والتخلص 
منه.الكود التالي يرسم صورة»ولكن يحجب القطع الناقص في الوسط باستخدام(!802)):مسار غرافيك لتأسيس قطاع قص مخصص: 
EES EM BAN O‏ ا ق الصورة الحقيقية 
Dim splashImage As New Bitmap ("C:\SplashImage. jpg")‏ 
Dim thePath As New Drawing2D.GraphicsPath ()‏ 
1 إنشاءمسار بيضوي والذي يشكل حجم الصورة التي سيتم اخراجها 
thePathn.AQdELlipse (20, 20, Splashimage.Width \ 2,‏ 
splashImage. Height \ 2)‏ 
IN TEN OEE RS 0‏ و الدي تغعطي كامل لوحة الرسح تفطاع ممستطلل فقفط 
e.Graphics. e Drawing2D.CombineMode. Replace)‏ 
رسم الصورة, والتي سيتم قصها 
e. Graph es Draw Image (SBlasRImaoe, 20, 2O,‏ 
splashImage.Width \ 2, splashImage.Height \ 2)‏ 
1 التنظيف 
thePath. Dispose ()‏ 


مخرجات هذا الكود تظهر في الشكل التالي: 


E Form 


المقاطع مفيدة أيضاً من أجل "اختبار النقر و١نأءها ٣‏ ".إذا رسمت صورة غير مستطيلة على فورم »وتريد معرفة متى سينقر المستخدم على الصورةولكن ليس على 
أي بكسل فقط من على الصورة بالكاملتستطبع استخدام قطاع ما والذي هو نفس شكل الصورة من أجل اختبار نقرات الفارة. 


عادةء أي شيء ترسمه على لوحة الرسوميات(الغر افيك) يتم وضعه مباشرة على سطح صورة نقطية.فهو يشبه شبكة ضخمةءوأوامر الرسم خاصتك تعمل بشكل أساسي 
على إسقاط الحبر الملون مباشرة في كل خلية شبكة.يمنحك كائن الغر افيك القدرة على تمرير أوامر الرسم خاصتك خلال تحويل هندسي قبل أن تظهر مخرجاتها على 
سطح اللوحة.على سبيل المثالءتحويل الدوران سيعمل على تدوير خطك أشكالك ونصوصك بالكمية التي تعينها(بالدر جة). ومن تم تطبيق النتيجة إلى سطح.بيين الشكل 
التالي نتائج الكود التاليءوالذي يطبق تحولبين©1)نقل القطاع(0,0) إلى اليمين 100نقطة(بكسل) وللا سفل 75 بكسلء»و(2)إضافة تدوير باتجاه عقارب الساعة من 


0درجة. 
CCEA ES DEAE MO ES EET SVSEEMRON ES. Delt SEE ONE, BEUSHES EB LEST OOD‏ 
e.Graphics.TranslateTransform (100, 75)‏ 
e.Graphics.RotateTransform (270)‏ 
E. GE aPRI CS .DrSWSETINIG COON, SUSEEMEONES  DeraUl EEORE, Brushes. Black, UO, T0)‏ 
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القصل الان عفر براحي الى Mhm76‏ 


e.Graphics.ResetTransform () 


Form] 


التحويلات ترأكميةإذا طبقت تحويلات متعددة إلى لوحة رسم.قإن أي أوامر رسم ستمر خلال جمبع التحويلات قبل الوصول إلى لوحة الرس..الترتيب الذي تحدث فيه 
التحویلات ھاہ.إذا تم قلب عبارات ras٥۲٣‏ ۲ ateاrans‏ و tate Transform‏ Rفي‏ الكود الذي شفلته للتو .فإن التدوير سيغير إحداتيات ۷ ,× لعالم لوحة الرسم 
بالكامل. التحويل اللاحق ل(100,75)سيتم نقله لأعلى المقطع100بكسل ومن تم لليمين 75 بكسل. 

فئة الغرافيك ءءاامة6۲ هذه الطرق التي تتيح لك تطبيق تحويلات إلى "المنظر العا ۷۴W‏ ١١٣هس‏ "للوحة الرسم خلال رسم ما يلي: 


تتضمن 


يعمل على تدوير المنظر العام(المشهد العام) في بالدرجات في اتجاه عقارب الساعة كه#إوهك مءiس)عهاء‏ من 0 إلى 359.ويمكن للدوران أن يكون موجب أو سالب. 


يضع عامل تدريج(موازنة) ٣0اه‏ و٠اهءء‏ لجمبع الرسوم.بشكل أساسي»يعمل على زيادة أو إنقاص حجم شبكة لوحة الرسم عند الرسم.تغير الموازن يؤثر على 
عرض الأقلام.إذا وازنة الكائنات بالعامل 2لا تظهر فقط الفراغات بحيث تصبح مرتين أبعد عن بعضهاءولكن جميع الأقلام ترسم أسمك بمرتين أيضاً عن الغير موازنة. 


نوع من طرق التحويل الرئيسية ٠4١50۲٣١20۸‏ اكه التي تتيح لك تطبيق تحويل من خلال كائن قالب.إن له خيارات أكثر من التحويلات القياسية المضمنة في 
كائن الغر افيك.على سبيل المتالء تستطيع تطبيق تحويل قص والذي يحرف جميع المخرجات في مستطيل إلى تفير من نوع متوازي مستطيلات-ها-هاو هاما 
„parallelogram‏ 


يعمل على إزالة جميع التحويلات المطبقة من لوحة رسم ما. 


يحفظ الحالة الحالية لسطح الرسوميات المحولة(أو الفير محولة) إلى كائن من أجل الاسترداد اللاحق.وهذا بتيح لك تطبيق بعض التحويلات.حفظهاءتطبيق تحويلات أكثرء 


استرداد مجموعة محفوظة من التحويلات. 


يتم تضمين الكثير من ميزات رسم ال +ا60في الدوت نت»ولكن نراه هنا قد يكون كافي لرواية عطشك ءاا†مممه ۲ار امطس.تستطبع عمل الكتير من الرسم الخيالي 
بال+ا60 .ولكن دعنا نواجهها:أنت وأنا مبرمجين.ولسنا فنانين . ولكن ولحسن الحظتوجد أشياء شبه فنية تطبيقية تستطبع عملها بال+ ا60 .واحدة من الميزات المهمة 
هي حامل الرسم(المالك سه۲ 6۲" سه ).مشاركة مسؤوليات الرسم بين الأداة وأنتء المبر مج(أنت "المالكW"۲س٠‏ ").تدعم أداة الصندوق المركب ×080ط٣٥C‏ مالك 
الرسم wn draw in9‏ للبنود المستقلة في القسم المنسدل ١0ذ٤0۲م‏ ١0Wل-م١٠ل‏ للقائمة. لنعمل على إنشاء أداة صندوق مركب»والتي تعرض أسماء 
الألوان.متضمنة عينة صغيرة من الألوان إلى يسار الاسم.اعمل على إنشاء تطبیق ویندوز جدید. وأضف آأداة صندوق مرکب سمها 080×1ط۸ ٥‏ إلى النموذج .۴٥۲۳٣۹‏ 
اعمل التفيرات التالية لأداة الصندوق المركب 080×1طصه : 
1. غıر‏ lëصıة .DropDownList aJ|DropDownStyle‏ 
2. غير lëصية .OwnerDrawFixed JJ|DrawMode‏ 
3.بدل خاصية ٠5‏ ]اء بإضافة أسماء ألوان متعددة كنصوص متميزة في نافذة محرر تجمبع النصوص١0ءهااه٤‏ و١٣)S‏ .إني عملت على إضافة 
والآن أضف الكود التالي إلى منطقة الكود المصدري لفئة الفورم .۴٠۲٣۸۹‏ 
Private Sub ComboBoxl1l DrawItem (ByVal sender As Object, ByVal e As System.Windows.Forms. DrawItemEventArgs)‏ 
Handles ComboBox1. DrawItem‏ 
1 ا ا ا 
If (e.Index = -1) Then Return‏ 
E A E SE E N N EEE‏ 


الفصل الثامن عشر:واجهة المستخدم. Mhm76‏ 
Dim colorBrush As New SolidBrush (Color. FromName (CStr (ComboBoxl. Items (€. E‏ 
إنشاء فرشاة ا ےک لے إا لحار مهدا التند ا ا 

Dim textBrush As Brush 

If ((e.State And DrawItemState.Selected) = DrawItemState.Selected) Or ((e.State And 
DEamI ems lale. HOE ORE) 

DrawItemState.HotLight) Then 

textBrush >= New SolidBrush (SystemColors.HIighIigRETExXE) 
Else 
textBrush = New SolidBrush (SystemColors.ControlText) 

End 1f 
احصول على الشكل لمنطقهةه عرض الملون‎ 

Dim colorBox As New Rectangle (e.Bounds.Left ¥ 4, e.Bounds.Top ¥ 2, (e.Bounds.Height = 4) * 2, 
@.Bounds.Heighl => 4) 
EE NM Dl ICE IN CESET ED 1 

e.DrawBackground ()‏ 
و رسم منطقة لون حخصص. 

€. Graphics. EillRectangle (eoloOrBrush, COlOLEBOX) 

e.Graphics.DrawRectangle (Pens.Black, colorBox) 
رسم اسم اللون إلى يمين اللون‎ 

e.Graphics.DrawString (CStr (ComboBoxl. Items (e. Index) ), ComboBoxl.Font, textBrush, 8 ¥ colorBox.Width, 
E EOSURIS LOP 1 (E. BOUNIS HENO  COMDOBO I. HONE HENO E) 70 20) 
E E E N E N E 1 
e.DrawFocusRectangle () 

۲ 


ف 
textBrush. Dispose ()‏ 
colorBrush. Dispose ()‏ 

End Sub 


ا ا الکن الوک اه هم ى الل اا 
HE] Formı1 Ey‏ 


FF 


gteen 


أداة ميكر وسوفت الأخيرة لبناءءواجهات مستخدم قريية الإنتاج وفعالة هي أساسيات تقديم llنlgفFoundatiori Windows Presentation‏ .أو NPF.وکما‏ في 
لینکو. ۷۴۴ تدمج لاع" عدة تقنيات مختلفة مع بعضها ضمن کل موحده‌اهW‏ ۵ہن . بعض من هذه التقنیات كانت معنا منذ عدة سنین.مثل نظام میکروسوفت 
ثلاثي الاأبعاد ٣ءء Microsoft's Direc132‏ والذي يعرض ويعالج العناصر ثلاثية الأبعاد30. تختصر ۷/۴۴/جمبع هذ التقنيات.وتجعلها متاحة من خلال 
XML-based descriptive language‏ اللفة التصويرية المعتمدة على ا۷N×‏ والمعروفة ب 4/1 (لفة ترميز التطبيق القابلة للتوسع ٥اطاوئہم†×م‏ 
.(Application Markup Language‏ 
تتضمن ۷۴۴ميزات وعناصر تتعامل مع عدة مناطق تقديم.من ضمنها الأدوات التي على الشاشةءاه٣؛٣هء‏ ٣ههإعء-nه‏ .الرسومات ثنائية البعدووہWiم۲ك‏ 25 
(مثل +ا60)ء الرسوميات (الغرافيك)نلاتي البعدئءاامة۲و 30 (من الأبعاد الثلاتية الاتجاه 130ء٠01‏ ) الصور التابتةكه وة |٣‏ ءناهاء (مثل صور 
P6ل).‏ الوسائط المتعددة التفاعلية ٣٥۵2‏ :اا" مi۷اعaامint‏ (الفيديو و الأوديو)ءوتقديم مستند "ماتر اه هو ما تحصل عليه ۷۷81۷۷6 "(مشابهة لمستندات 
۴۴ ).يمكن جعل العناصر المستقلة وكامل واجهة المستخدم حيوية ١6ا2‏ ٣ه‏ بشكل آلي»أو في حالة الاستجابة لتفاعل المستخدم. 
عندما يحين الوقت لعرض محتوى ۷۴۴ .تستطبع إحضاره إلى المستخدم في عدة طرق مشتركة. يمكن أن يتم بناء ملفات ا۷ ۸×وما يتعلق بها من كود دوت نت في 
تطبيق قائم بذاته.وهو مشابه كثيراً لتطبيق نماذج ويندوز للدوت نت النموذجي.ولكن مع العديد من الهبات المدهشة للمظهر والتي في التطبيق العادي أو القياسي لايمكن 
للمطورين الوصول إليها. 
يمكن أيضا استخدام ۷۴۴ لنتاج تطبيقات معتمدة على الويب يتم استضافتها على متصفح الانترنت۲ 0۲٠١۷568‏ .في الحقيقة. العناصر التي تصممها للاستخدام في تطبيقات 
تخطیط سطح المكتب ٣5‏ 0ااةء‌ااممه مار†ء-مها)دهه يمكن أن يتم استخدامها على الويب بشكل عام بدون أي تعديل.وكما تتوقعءقيود الأمن تضع المثبطات على بعض 
الأشياء التي تستطبع عملها عند التشغيل في مستضيف من هذا النوع. 
برامج ۷۴۴ المعتمدة على المتصفح تتطلب أن يتم تثبيت كل من مكتبات إطار عمل الدوت نت و ۷۴۴ مع إمكانية الوصول إليها على شبكة(أو كمبيوتر)العميل.تبني 
ميكر وسوفت الكثير من تلك التقنيات وتحزمها في منتج يدعى ۸1 S//۷€///9‏ .المصمم للكمبيوتر والذي هو كثير الشبه بمنصة فلاش أدوبي 45ا۴ ك'#ط0كA:ونظام‏ جافا 
إف إکس ٣۳عاءرءs‏ ×۴ va‏ هل لشرکة سان میکر وسیستم5¥5†۵٥Micr‏ Sun.سیسمج‏ †nوiاverاSiفي‏ النھایة للمحتوی المرتبط لکل من ا۸و دوت نت لان 
يعمل علی منصات بدون نوافذs‏ "۲ ٥]tھ‌ام‏ sسWindow-n0n‏ .مثل حاسوب ماکینتوش 1 Macin‏ . 
تشكيلة تالثة تستخدم مجموعة جزئية من ا۷ ۸×لتعریف مستند تابت شبيه ب بي دي إف st tiءع ه0هcعںu "6٣‏ ikeا-۴D۴‏ .مثل المستندات التي تعرف بمستندات 
۶(توصیف الورقي(آو آلمستندي) Paper Speci ca i07‏ اXM).وعملياً‏ هي ملفات 2۱۴تحوي علی جمیع صفحات ا۸1 الرسومیات‌5ء ام ۲۵و .وعناصر 
الصفحة الأخرى في ملفات متميزة ضمن الأرشيف. 
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القصل الان تر إراحهة الكت Mhm76‏ 


واحدة من العلامات المميزة في تصميم التطبيق ضمن ۷۷۴۴هو الفصل بين المنطق والتقديم.وهذا الهدف مشترك بين العديد من التقنيات الجديدة.من ضمنها »و _ 
SP. NE‏ .كل منطق التطبيق- أي جميع الاحدات التي يتم إطلاقها من قبل مدخلات المستخدم وأفعال النظام- يتم كتابتها في كود دوت نت قياسي.ويمكن أن تظهر أيضاً 
واجهة المستخدم الغرافيكية ككود دوت نتءمع الكائنات المنشئة خارج ۷۴۴ المخصص لفضاء الأسماء ws‏ هل١1‏ ۳.۷ءرS‏ .ولكن الأكثر شيوعاً تصميم عناصر 
واجهة المستخدم والآأدوات المشتقة من خلال ا١‏ A۸×.وتخطيط‏ ا۷ ×الذي يمكن إنتاجه من قبلك في الفيجوال أستوديو أو المفكرة أو بواسطة أدوات تانوية. 

لأن محتوى ا ۸×يمكن أن يتم بناءه خارج تطبيقهفتخصص تصميم واجهة المستخدم مع معرفة برمجية محدودة يمكن أن تبني مكونات واجهة المستخدم بشكل منفصل 
عن عمل المطور على منطق التطبيق.توفر ميكر وسوفت أداة لمثل هذه المصممات.تدعی 8/۸2 ressi0۸م Ex‏ اsoئMicro‏ . التصميم التعبيري Expressi0¬‏ 
واه واحد من المنتجات القليلة.توفر بعض الشركات الأخرى أدوات إنتاج محتوى ا۸۸۷×غني. 

تتيح لك الفیجوال آستودیو إنشاء تطبیقات ۷/۴۴ كاملة بالاعتماد علی محتوی ا1 ۸×.لبناء تطبیق ۷۷۴۴ »ابداً مشروع فیجوال آستودیو جدید.أنشئ مشروع جدید ۸6۷ 
tاcەزoام.واختر‏ من صندوق حوار مشروع جدید New ۴٣ہزع C٤‏ قالب تطبیق ۸٥ااھ‌iاممA‏ ۴ WP‏ ضمن نوع مشروع الفیجوال بیسك.ومن تم انقر موافق)0 .تعمل 
ويندوز على إنشاء مشروع نمانج ۷۴۴جديد مياشرةءعارضة نموذج البدءء ۷1٥۷1‏ شاهد الشكل التالي. 


90 WplApplicationl - Microsoft ¥Yisual Studio EES 
File Edl View Project Build Debug Data Format Tools Test Windom Help 
MET ET ETE ETC ECE 


Window .xamll” Window1.xamlvb Start Page کت‎ 


KEETE 
ıaıoûxa uennes yl 


semeda 


Tq Design , 8 E AML | 
8 EEN indo x:Clasa="Windov1” 
xmlns="hjttp:/* schemas. microzoft. com’ winix/ 2 DDE xaml# presentation" 
xmlna :x="hLtp:# f achemas. microsoft . com# uinfÊx# 20D 6# xaml" 
Titie=irdovi" Height="a O0" TiAEh= PIO 
2 <Grid> 
tfGrEiQdz* 
< 


# Tindow> 


window Window 


Ready 


واجهة المستخدم معرفة بالكامل بواسطة مجموعة ا ×المعر وضة أسفل النموذج(أو النافذة).حالياًتعرف نافذة التطبيق النهائية نفسها. 
<Window x:Class="Windowl"‏ 
xml1ns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"‏ 
xminSsix INELP://sehemaS . MICE OSOE E. COM/wWInRExX/200 6 Aixam Û‏ 
Title="Windowl" Height="300" Width="300">‏ 
TE E‏ 
CEE‏ 
</Window‏ 
يعرف هذا الكود النافذة. 1سهل١۷1.والتي‏ لديها فئة سەك System. Windows. Win‏ حقيقية.مواصفات وسم نافذةاMN‏ ۸× .تتضمن العنوان 8|¡ »الا رتفاع Height‏ 
والعرض ١‏ ل۷۷1 »مر تبطة بالخاصيات 5٠م‏ ٠۲ملنفس‏ الاسم في فئة النافذة ه۷0 .دعنا نضيف بعض الإثارة لهذه الفورم»سأعمل على إضافة زر يتضمن قوس 
قزح 0Wط٣أهاعلى‏ واجهته»زائد إضافة لمعة صفراء حول الزر»سأعمل أيضاً على إضافة معالج الحدث الذي يظهر صندوق رسالةءكما مع تطبيق نماذج ويندوز 
القياسيء فإك تستخدم الأدوات في صندوق الأدوات لبناء الفورم.سأعمل على سحب زر إلى سطج الفورم واستخدم منطقة نص ا ۸×لجلب حياة جديدة إلى النافدة. 
<Window x:Class="Windowl"‏ 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"‏ 
xmIRS x>" REED://SCREMSS MI CEOS E COM/WIDE X7 200G xam lL‏ 
Title="Window1l" Height="160" Width="411">‏ 
<Grid>‏ 
SBUEEOn Maron 05, 20, I9, SS Name LBUEEONL L>‏ 
<Button.Foreground>White</Button.Foreground>‏ 
SEMEEOR EOS ze LSE VEUE EON E ORESI ZE >‏ 
<Button.FontWeight>Bold</Button.FontWeight >‏ 
BUE ECM. Baek IEOUNA‏ 
<LinearGradientBrush>‏ 
<LinearGradientBrush.GradientStops>‏ 
<GradientStopCollection>‏ 
GEFAULEDESEOD Color= Red OEESEE OL >‏ 
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Mhm76 الفصل الثامن عشر:واجهة المستخدم.‎ 
EEO LENEGEOE COlOE Orange ORESe E O AAS 
<GradientStop Color="Yellow" Offset="0.285"/> 
<GradientStop Color="Green" Offset="0.4275"/> 
<EradIENESEOS COlOEB Nel Oacse C> O. SMS 
<GradientStop Color="Indigo" Offset="0.7325"/> 
CGESILENESEOE COLOE VOCE OEESEE O OMI 
VECradienESEOPCOLLEC EONS 
</LinearGradientBrush.GradientStops> 
</LinearGradientBrush> 
ABUEEODN .BACKOEOUNAS 
<BULEOnNn. BELEMapEHEEeGEZ> 
<OuterGlowBitmapEffect /> 
<VBUEEODNn BIENapEEEEecE> Click Me 
MBUE EON 
MOEA 
</Window> 
ساعمل أيضا على إضافة معالج حدثءباستخدام نفس الطريقة المستخدمة في مشاربع نماذج ويندوز وذلك بالنقر المزدوج على الزر ليظهر معالج حدث نقر الزر ولنكتب‎ 
بداخله صندوق رسالة كما يلي:‎ 
Class Windowl 
Ean va ee SUS BUCEON N CINE ENEVUAL Sende AS SS EemM OSNEOE El ES 
System.Windows. RoutedEventArgs) Handles Buttonl.Click 
MsgBox ("Hello;world"™) 
EAS SUD 
Endl CIES 


شغفل هذا البرنامج بالضغط على المفتاح ۴5يعمل البرنامج كما هو مبين في الشكل التالي: 


WE WYindowl 


Click Me 


YY piApplicationl RK 


Hella:warld 


ماقف 


مواصفات تعديل فة ٠ه us‏ طا٣att‏ وmodifyin-assاشيء‏ ما ناقشناه في الفصل الأُولءوليس لها علاقة بال +ا60.أردت فقط أن أذكرك بها بما أننا 
سنستخدمها في كود مشروع هذا الفصل. 
اظن فو اضنات هدل دة ار خف فال فرك آ5 اقفن رفن أ كاك عل اك اال كى اة الوا عار ة6 6اا ا 


.SomeOldClass 
<ObsoleteAttribute () > Class SomeOldClass 


: ا کن ا م 
el CIES‏ 

بإمكانك أن لاتضع الجزء" #أuطذ٣))A‏ "للمواصفة إذا كان اسم المواصفة لا يتعارض مع كلمة محجوزة للفيجوال بيسك (أي أن تكتب اسم المواصفة فقط عأماهءطات). 
تظهر المواصفات كميتاداتا (توصيف بيانات ه402٠"‏ )في المجمع النهائي المتر جمءويتم استخدامها بواسطة الفئات والتطبيقات والتي ءبشكل تصميمي»تستخرج 
مدلول(مغزى) مواصفات معينة.في كود هذا الفصلءسنستفيد من الأداةلن6راممهء۴ .الأداة التي تنفذ خاصيات لوحة ضمن بيئة تطوير الفيجوال أستوديو»وعلى الأغلب 
تستخدم لتعديل خاصيات أداة وفورم»واستخدام هذه الأداة متاح لك في تطبيقاتك الخاصة.لاستخدامهاء اسند حالة أو نسخة فئة إلى خاصية الأداة 6ز 40ءاءءاSe»ومن‏ 
ثم»بشكل سحري.تظهر جميع خاصيات الكائن في قائمة خاصيات الأداة.. 
ولكنها ليست مفضلة دائماًءيمكن أن يكون لكائنك خاصيات يجب أن لا تظهر أو يجب عدم عرضها.لقد تم تصميم الأداة كي تكون شاملة أو عامة.ولا تعرف شيء حول 
احتياجات كائنك.لذلك فهي لا تعرف أي خاصيات يجب عدم تضمينها.هذا كل شيء فهي لاتعرف حتى تخبرها أنت من خلال المواصفات.بإضافة مواصفات معينة لخاصيات 
فئتكءفإنك تخبر الأداة ١ا6را۲ممه٣۴كيف‏ تعامل أعضاء كائنك.على سبيل المثالء تخبر المواصفة Browsable Attribute‏ دا rid‏ ertyGم۴r0pلتضمین(في‏ حال کانت 


مu‏ )أو إخراج(في حال كانتهءاه۴ ) خاصية. 
<Browsable (False)> Public Property SecretProperty( ) As String...‏ 


سأقدم لك تفاصيل إضافية حولها عندما نستخدم الأداة ١أ6۲ر†۲ممه٣۴فيما‏ بعد في هذا الفصل. 
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الفضل الان ثرو اجهة المتخدم Mhm76‏ 

لقد استخدم مشروع المكنبة ميزات ال +ا0منذ اللحظة الأولى عند إنشاء أول فورم في المشروع.ولكن كل هذا كان بدون تدخل منك بها أنه مضمن في إطار 
العمل.والآن حان وقت وضع لمساتك الخاصة»كمبرمج.من أجل إضافة ال +01 الخاصة للتطبيق.في هذا كود مشروع هدا الفصلءسنعمل على استخدام +ا60لتحسين 
العرض العادي لأداة من خلال حامل ميزات الرسم.زائد.أننا سنعمل على البدء أخيراً بتنفيذ بعض ميزات كود التعريف ٠0ء‏ 4۲ط التي أغريتك بها في فصول سابق. 


إذا لم تحصل حتى الآن على خط كود التعريف†١0؟‏ 00#ء 4۲ط .فهذا الوقت المناسب لعمله. الميزات المضمنة في كود مشروع هذا الفصل سيطلب منك استخدام خط 
يمكنك شراء خط كود تعريف احتر افي.ولكن تأكد من أن الخط الذي حصلت عليه هو نوع خط حقيقي.(راجع الملحق ۸) 


في الفصل السابق»عملنا على إضافة الفورم 0.۷6ا877100۸)/ مع عروضها المتعددة لبنود المكتبة.واحد من هذه العروض المضمنة الأداةء#ااوہ ٣٥ا‏ . صندوق 
قائمة ×0طاءاامتعدد الأعمدة تعرض٥٣4۳١/۸0۲اAu‏ . استدعاء عددامطصں. .وأعمدة لنوع الميديا(أو الوسيطةءمر٣‏ هله“ ).على الرغم من أننا خڑنا البيانات 
الخاصة بعمود ضمن كل بند سابقءلم نعرض حةاً الأعمدة المستقلة للمستخدم. 
الشيء الذي يخص عرض القوائم المتعددة الأعمدة و النصوص الأخرى المحددة بفراغات هو أن بعض النص يكون محصور بمنطقته رسمية مسبقاً إذا سمحت له بذلك. 
على سبيل المثالءيمكن للنص في عمود قائمة واحد أن يتداخل إلى نص عمود أخر.في مثل هذه الحالات.فقد أصبح من العرف بتر المحتوى الإضافي واستبداله بعلامة 
الإضمار كأمااه ("...").لذلك فإننا بحاجة إلى روتين سيحدد فيما إذا كان النص طويل جداً بالنسبة لمنطقة عرضه»وعمل بتر وإضمار عند الحاجة.أضف الطريقة 
۴e» Width‏ إلى كود الوحدة البر مجية G٥ "ea. V0‏ . 

Public Function FitTextToWidth (ByVal origText As String, ByVal pixelWidth As Integer, ByVal canvas 

AS System. Drawing. Graphics, _ 

ByVal useFont As System. Drawing.Font) As String 
کد ا ا کک ین اا دا ی اا ااا اا‎ 
بتر وإضافة علامات الإضمار عند الجاجة.‎ 

Dim newText As String 
newText = origText 
If (canvas.MeasureString (newText, useFont) .Width () > pixelWidth) Then 

Do U LES (ESNUES MEAS OEE ROT GC Fy USCC) WEE | 

> pixelWidth) 


newText = Left (newText, newText.Length - 1) 
If (newText = "") Then Exit Do 
Loop 
EE (newlezst <> 1") Then nevwlext G&G lT 
e 


Return newText 
End ELNGCELON 


إن النموذج up‏ )ەا 6)/ لدیه زر ”رجوع" الشبيه بمتصفح الانترنت مع قائمة سياق(أو انسدال) للمدخلات الحديثة.البنود المضافة إلى هذه القائمة يمكن أن تتضمر 
عنوان كتاب وأسماء مؤلفين طويل جدآً.دعنا نستخدم الطريقة ۸ال ۴٣٠×٣١۷‏ لتحديد حجم بنود النص في هذه القائمة.افتح الكود المصدري للنموذج مup)مما)!‏ 
واعمل على إيجاد الطريقةءہ 8u)‏ )عه ۸8ءءRefr‏ .واستبدل السطر التالي من الكود . 


بالسطر التالي. 


whichMenu. Text = FitTextToWidth (scanHistory.HistoryDisplay, Me.Width \ 2, useCanvas,whichMenu. Font) 
هذا سيعمل على تقيد نص بند قائمة إلى نصف اتساع الفورم»وهذا يبدو معقولاً بالنسبة لي.ولكن المتغير ه٠ .,ةء٤١ءءن جديد.لذلك أضف التصريح عن هذا المتفير في‎ 
.RefreshBackButtons ةةuرطفJl‎ یلJeİ‎ 


whichMenu.Text = scanHistory.HistoryDisplay 


Dim useCanvas As Drawing.Graphics = Me.CreateGraphics ()‏ 
ونحتاج أيضاً إلى التخلص من لوحة الرسم الفرافيكية ۸۷25ء التي عملنا على إنشاءها من خلال التصربح عن المتفير في السطر السابق» ويتم ذلك عند نهاية الطريقة. 
لذلك أضف الكود التالي قبل سطر نهاية الطريقة طنا؟ كع . 
useCanvas.Dispose ()‏ 
والآن لنعالج حامل رسم 0۷٣6۲ ۲2W‏ بنود قائمة.تسمح لك أدوات صندوق القائمة ×180ءااستخدام كود رسم خاص من أجل كل بند مرئي في القائمة.لديك خيارين 
عندما تدير البنود المرسومة بنفسك:تستطيع الحفاظ على كل بند بارتفاع تابت»أو تستطيع جعل كل بند قائمة بارتفاع مختلف بالاعتماد على محتوى ذلك البند.في أداة 
صندوق القائمة ء"٣ءااوااءاة1ءسنعمل‏ على استخدام نفس الارتفاع من أجل كل بنود قائمة.لتمكين نمط حامل الرسم 0۷٣8۲ ۲W‏ »افتج محرر تصميم الفورم 
tem Lookup‏ اختر أداة صندوق القائمة "اوہ على الفورم أو من خلال لوحة الخاصيات«وغير خlصتlq .OwnerDrawFixed J| Draw Mode‏ 
كل بند قائمة مطابق سيتضمن سطرين من البيانات©1)عنوان البند المطابق.بخط غامق»و(2)الأعمدة الثلاث للمؤلف» رقم الاستدعاءءنوع الميديا(أو الوسيطة)البيانات. 
أضف الكود التالي إلى معالج حدث تحميل الفورم الذي يحدد كامل ارتفاع كل بند قائمة»وموضع السطر الثاني ضمن كل بند. 
ErIvatê SUS LESMLOOKEUS LOG EY Ua U Sende AS SSE OBNEC E, ByUal € AS SVSEEM. EMERNEAEIS) Handles‏ 
MyBase.Load‏ 
تحضير الفورم 
Dim formGraphics As System.Drawing.Graphics‏ 
1 وع ارتقاع البنود القراضى ف دروت اة 
matching items‏ 
formGraphics = Me.CreateGraphics ()‏ 
MatchingItems. ItemHeight = CInt (formGraphics.MeasureString ("A" & vbCrLf & "Gg",‏ 
Mallen inal tems Rone Hes GhE DJ) OS‏ 
SECORGd TIE EMRO = CINE (E OEMGEAORTE SE Meas UEe sS EEA RAST‏ 
Ma Ee Ino I EemSs. OnE) Hel GRE O) TG‏ 
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Mhm76 
formGraphics. Dispose () 
End SUS 


استخدمت النص " و "لاتأكد من أن الارتفاع يتضمن جميع الخطوط المرتفعة ١۲٥ل"‏ عه والنازلة ك#۲ل٣ءءءهلعن‏ مستوى السطر(الأجزاء التي تبرز للأعلى أو 
للأسفل من معظم الحروف). أعتقد أن الحساب سيتضمن تلك القيم حتى ولو استخدمت " ۳" " من أجل النص.ولكن من الأفضل.وضع الخاصية 
tems.ltemHeightاMatchingلتشير‏ إلى حجم جميع البنود في القائمة.إذا قررت استخدام بنود متفيرة الارتفاع بدلا عن بنود ذات ارتفاع تابت»كان يجب علينا معالجة 
حدث ۳٠٤ا‏ suةهM.من‏ خلال الينود ذات الارتفاع التابت نستطبع تجاهل ذلك الحدثءوالانتقال إلى الحدث الذي يعمل رسم حقيقي: ٣‏ #اسها5. 

إليك ما سيعمله الكود من أجل كل بند قائمة©1)إنشاء كائنات الفراشي والخط الذين سنستخدمها في الرسم»(2)رسم السلسلة الحرفية للنص على لوحة رسم بند قائمةءو(3) 
التنظيف أو الإزالة.بما أنه يمكن أيضاً أن يتم اختيار بنود قائمة أو عدم اختيارهاءبالتالي سنستدعي بعض الطرق الموفرة من قبل إطار العمل لرسم عناصر الواجهة 
والخلفية المناسبة والتي تشير إلى اختيارات بند . 

عندما نرسم عدة أعمدة نص » من المحتمل أن يكون واحد من الأعمدة طويل جداً ويتداخل مع منطقة العمود التالي.وكان هذا هو السبب في كتابة الدالة ۸¡ ۴it ۲ex۲0W‏ 
سابقاً. ولكن بدوره يتضمن ال +ا60سابقاً ميزة تعمل على إضافة علامة الإضمار لانص عند الموضع اليميني عندما لا يكون مناسياً. وهذه الميزة موجودة في فئة تدعى 
Format‏ String.في‏ خاصیتھا وہiص٣‏ |۲۲ »اسند هذه الخاصية إلى characte‏ sءsiمiااEواستخدمھا‏ عند رسم نص سیتم بتره لیصبج مناسب في الاتساع.عندما نرسم 
النص على لوحة الرسم»سنعمل على توفير مستطيل ءاو١هاءه۲يخبر‏ النص عن حدوده.إليك الكود الاساسي المستخدم لرسم عمود واحد من النص المبتور. 


Dim ellipsesText As New StringFormat 

ellipsesText. Trimming SEE ROE mma MO EL IPSS SE RAESCEO SE 
e.Graphics.DrawString ("Jaıgط‎ ln pi", e.Font, someBrush, New Rectangle (Left, 
ellipsesText) 


الكود الذي سنستخدمه لرسم كل بند قائمة في القائمة "٠او‏ ء1ة۷سيستخدم كود مشابه لهدا.لذلك لنعمل على إضافة هذا الكود الآن إلى معالج حدث 


.Matchingltems.Drawltem 


الفصل الثامن عشر:واجهة المستخدم. 


TOP 


Width, Height), 


Eri vate SUS MelleRInGI Eems DMEawIeem(EvyVal Sender As OBect, BYU @ AS 
System.Windows.Forms.DrawItemEventArgs) Handles MatchinglItems. DrawlItem 


رسم البنود المتطابقة على سطرين 
Dim itemToDraw As MatchingItemData‏ 
Dim useBrush As System. Drawing. Brush‏ 
Dim boldFont As System.Drawing.Font‏ 
Dim ellipsesText As StringFormat‏ 
: رسم خلفية البند 


If (CBool (CInt (e.State) And CInt (DrawItemState.Selected) )) Then useBrush 
SystemBrushes.HighlightText Else useBrush SystemBrushes.WindowText 
e.DrawBackground () 


1 ا اا ان حط اة اا م ن اد رک 
boldFont = New System. Drawing. Font (e.Font, FontStyle.Bold)‏ 
الخحصول عل االحضته لر 
itemToDraw = CType (MatchingItems. Items (e.Index), MatchingItemData)‏ 
ellipsesText = New StringFormat‏ 
ellipsesText.Trimming = StringTrimming.EllipsisCharacter‏ 
رسم نص يبند 
E GEAR ESE DEAS EE IMG (E EEeMLODE aw ETE ley, BOLSEONE, USeBEUSR, |‏ 
New Rectangle (0, e.Bounds.Top, ItemColEnd.Left - MatchingItems.Left,‏ 
boldFont.Height), ellipsesText)‏ 
ê. GEAR CES DE aAWS Er IE (I E eMTLODE aM AUEROE, Ce EONE, USSBEUSM, |‏ 
ew Kec E ang LE (LEEMCOLAUERNSE. Het Ey € EOUNGS TOD i SECONAT EERO, |‏ 
ItemColCall.Left - ItemColAuthor.Left - 8, e.Font.Height), ellipsesText)‏ 
e. GEAPRI CS. DEawS Er ING (1 EemMLODE aw Cal Number, e. EOne, USeBrEUSM, |‏ 
Mew RecEangle( Eemcol Cal Tere, Ce EOUNdS .TOBI | SECONGI EEMROM, |‏ 
ItemColEnd.Left - ItemColType.Left, e.Font.Height), ellipsesText)‏ 
e GE ap RIES. DEaws EE IRE (ME eMNODE a Medi anye, GC EOE, MSEBrEUSM, |‏ 
Mew Reccangle(IEemcol ype. ler E, e. EOUNdS . IOBl | SECON EEMROM, |‏ 
ItemColType.Left - ItemColCall.Left - 8, e.Font.Height), ellipsesText)‏ 
إذا كان التركيز على صندوق القائمة ,ارسم مستطيل التركيز 


e. DrawFocusRectang le () 
boldFont.Dispose () 
ERA SUS 


كما ترى من السهل رسم أي شيء تريد في بند صندوق قائمة. في هذا الكود»المخر جات الفعلية للوحة الرسم بواسطة ال +ا60المكافئ لعبارlت DrawSİring‏ 
الأربع.على الرغم من أن قاعدة بيانات المكتبة لا تدعم هذاءكان بإمكاننا تضمين صورة عن كل بند في قاعدة البيانات»وعرضه في صندوق القائمة هذاءإلى يسار العنوان 
تماماًء وأيضاًءتسمح الاستدعاءات e.DrawBackground‏ و e.DrawFocusRectangle‏ للأداة من التعامل مع البند الصحيج المعلم(أو المظلل)(على الرغم من أنني لم 
اختار فرشاة نص مناسبة).يبين الشكل التالي نتائج عملنا الجاد. 
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لفصل الثامن عشر :واجهة المستخدم. 


([ جع ل 


بنود بواسطة مؤلف الاسم 'كألو ,واوو" 


Mhm 76 


يتضمن مشروع المكنبة دعم شامل للصاقات كود التعريف.لقد زرت العديد من المكتبات وقارنت أكواد التعريف المضافة لكل من بنود المكتبة(مثل الكتب) وكروت معرف 
الزبون.وجدت أن التشكيلة كانت واسعة بحيث يضيق حيز حل محدد مسيق أن يتسع لها.وهكذاءيسمح تطبيق المكتبة للمدراء أو أمناء المكتبة من تصميم صفيحة لصاقات 
كود تعريف تلبي حاجاتهم الخاصة.( هناك أعمال ليع لصاقات كود تعريف وكروت مطبوعة مسبقاً لمكتبات لاتطبع هذه الكروت واللصقات يدعم التطبيق أيضاً هذه الطريقة 
بما أن إنتاج البار كود وإسناد البار كود إلى البنود خطوتين منفصلتين).لدعم تصميم بار كود شامل. سنعمل على إضافة مجموعة من الفثات المصممة ونموذجين إلى 


التطبيق): 


BarcodeltemClass. vb 


يحتوي ملف هذ الفئة ست فئات متميزة.واحد منها هو الفثة القاعدية من أجل الفنات الخمس الباقية.تصمم الفثات المشتقة عناصر النص الثابتةصور البار كود.أرقام البار 


كود. الأسطر.والمستطيلات التي سيضيفها المستخدم إلى سطح لصاقة بار كود واحد. 
BarcodePage. vb‏ 


هذا النموذج هو فورم محرر مشتق من 84۵٥00۵٠۴٠۲۳‏ نفس الفورم القاعدي المستخدم من أجل محررات الكود المتنوعة في التطبيق.تعين هذه الفورم ترتيب صفيحات 
اللصاقة.من المحتمل أن يشتري المستخدم صفيحات لصاقة من مخزن مكتب محلي.بإدخال رقم صفوف وأعمدة اللصاقةحجم كل لصاقة »وأي فراغ بين وحول كل 


لصاقةءيمكن للمستخدم أن يصمم إلى حد بعيد أي صفيحات لصاقة نظامية. 
BarcodeLabel. vb‏ 


محرر أخر معتمد على ٥0١۵۴٠١۲۳‏ ۵ءه8٧.تتبج‏ هذه الفورم للمستخدم من تصميم لصاقة بار كود مفر د بإضافة نصءاليار كودات. الأسطر»والمستطيلات إلى منطقة 


العرض.في فصل لاحق. سنعمل على إضافة طباعة اللصاقة.حيث يتم دمج اللصاقات والصفحات مع بعضها في عمل طباعة رائع. 


بما أن هذه الملفات الثلاث تتضمن حوالي 2,000سطر من الكود المصدري»سأبين لك فقط مفاتبح المقاطع لكل واحد منها.فقد عملت على إضافة هذه الملفات الثلاث إلى 
كود المشروعء» لذلك لنبدأ بالملفطs.۷ءو/٤77.ع/0۵26-/84‏ .فهو يعرف كل نوع ليند معروض سيعمل المستخدم على إضافته إلى قالب اللصاقة في الفورم .إليك كود 


ملخص للفئة l|لقاعدية .BarcodeltemGeneric‏ 


Imports System. ComponentMode lL 

Public MustInherit Class BarcodelItemGeneric 
<Browsable (False) > Public MustOverride ReadOnly Property ItemType() As String 
BubDl1@ MuSstOuverr 11dê Ouerrides EUNGCEIOR TOSELrINS () AS String 


ENG Class 


لايحدث الكثير هناءتعرف الفئة عضوين مطلوبين: خاصية نصية للقر اءة فقط مسماة #مر |٤٠١٣‏ ومتطلبات توفر ها الفتات المشتقة من أجل تنفيذ خاص بها الطريقة 
وا8 . الفئات الخمس الأخرى المشتقة في هذا الملف تحسن الفئة القاعدية لدعم أنواع مميزة لعرض العناصر المضمنة على لصاقة بار كودلنلقي نظرة سريعة على 


واحدة من هذه الفئات. الفئة اعم ءامل ء84۲ التي تسمح بتعبئة مستطيل بشكل اختياري ليظهر على لصاقة الكودءوتتضمن أعضاء 


temRect 


خاصة تقتنص تفاصيل المستطيل. 


PUDUIE Class Barcode L 


1 ل 0 E‏ ا ار که 


temGeneric 

۲ 
tLeft As Single 
ETOP AS Single 
tWidth As Single 
tHeight As Single 
EONS AS DESIR COLOE 


Inherits Barcodel 
ان ات اا ا ا‎ 
Private StoredRec 
Private StoredRec 
Private StoredRec 
Private StoredRec 
Private StoredRec 


Private SEOEeQdEIILCOLO:E AS Drawing. COLSE 


tAngle As Short 
يتضمن باقي الفئة خاصيات توفر واجهة عامة لهذه الأعضاء الخاصة.إليك الكود من أجل الخاصية 0۲اه ۱۱ز۴:‎ 


Private StoredRec 


KBrOowsab le (Tr ue), DeserIDE1 ORA EEA DU Ee و( اا ال ت لن 4ض(‎ | 
BUDGE BrODerEyY HIlLCOLOSE (J AS Dean. CEOlOE 


لون التعبئة 
Get‏ 


RetUrh SEOEeQE1 LICSLOE 


End Get 


Set (ByVal Value As Drawing.Color) 
StoredFillColor = Value 
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End Property‏ 

مثل معظم الخاصيات الأخرى»فهي تضع وتستخرج القيمة الخاصة المناسبة.يتضمن تصريحها مواصفتين سيتم قراءتهما بواسطة الأداة ۲|۵ ٠۲۲۷6‏ م٠۴۴‏ فيما بعد.تقول الخاصية 

eاsab Brow‏ "نعم.ضمن هذه الخاصية في الشبكة ل١9۲‏ ".وتضع الخاصية هان طأ٣)tionAمiعsهطالنص‏ الذي يظهر في منطقة المساعدة(أو التعليمات)في الأسفل للأداة 

.PropertyGrid 

عندما استخدمت لوحة الخاصيات لتحرير نموذجك.فقد كنت قادر على وضع ألوان من أجل خاصية اللون باستخدام أداة اختيار لون خاصة مينية ضمن الخاصية. مجرد أن 

يكون لديك خاصية معرفة باستخدام ٣هاهع٣.‏ واس Systm.‏ فهذا كافي لتمكين نفس التخصص الوظيفي من أجل فئتك الخاصة.ولكن كيف يعمل هذا؟مجرد أن يكون 

للخاصية ۲٥اه‏ ۴|۱مواصفات يتم تميز ها بواسطة الأداةلا6 را مم۴ .ولدى الفئة هاه٤.واسها.mهاءرك‏ أيضاً مثل هذه الخاصيات.واحد منها تعرف فئة محرر 

خاصية خاصة من الألوان.وتنفيذها يقع خلف مجال هذا الكتاب» وعلى أية حال جامدة.إذا كنت مهتم بمثل هذا العمل من أجل فئاتك الخاصةءتستطبع قراءة مواضبع 

بخصوص محررات شبكة خاصية من مستندات ميكروسوفت. 

قبل أن ندخل إلى نماذج التحرير »ساتيح لك معرفة شيء ما يخص دعم الدوال التي أضفتها منذ حين إلى ملف الوحدة البر مجية 6€۵/4/.۷6. 

BuildFontStyle:allJl 

أنماط الخط(مثل غامقءومائل)هي مجموعة في کائنات الخط تستخدم أعضاء العداد eار†S٤ ٣‏ ۴.وSystem.Drawİn.ولکن‏ عند تخزين معلومات خط في قاعدة 

البيانات»اخترت تخزين إعدادات الأنماط هذه باستخدام أحرف(مثل 8من أجل الغامق ١اه‏ ).تعمل هذه الدالة على تحويل الحرف إلى قيمة نمط الخطعار†؟S†ہه۴‏ . 

ConvertPageUnits: ةllJl‎ 

يتيبح لك محرر اللصاقة ك١0ااكه‏ ا#طه اوضع البنود في عدة أنظمة قياس مختلفة .متضمنة الانش والسنتيمتر .تحول هذه الدالة القياسات بين الأنظمة المختلفة. 

DBFontStyle:llJl 

هذه الدالة عكس الدالة هار† 4۴٥١٤5‏ ا8ء تحضر قيمة نمط خط هار†۲5٤١٠۴من‏ أجل إدخالها في سجل قاعدة البيانات. 

GetBarcodeFont :ةllJl‎ 

تعود هذه الدالة باسم خط البار كود.إذا تم تركيبه. تسمح الفورم للمستخدم من تعريف صفيحة كاملة للصاقة.وليس اللصقات نفسها ولكن مواضع لصاقات متعددة على نفس 

صفحة الطباعة.ييين الشكل التالي الحقول على هذه الفورم مع بعض عينات البيانات. 


تجرير كالب صغجة البار كود 


اتساع ال فقحة: 
ارتغاح الصقحة: 
الغوامش اليساية: 
ال#وامش اليضينية: 
ال#وامش الجلبا؛ 
الجوامش السفلية: 
الحمود الداخلي : 
الصف الداخلي: 
حالب اللصاخة 
الصغوف: 


ج 
الاعصدة: 


إجمالاًءتشرح الحقول على الفورم حجم الصفحة وحجم كل لصاقة تظهر على الصفحة.عندما يعمل المستخدم على إدخال القيم.فإن منطقة معاينة الصفحة تتجدد مع المعاينة 
لما ستبدو عليه الصفحة.بما أن الكود مشتق من الفورم 845۵٥04۵۴0۲۳‏ .فإن المنطق في الفورم معروف لك مسبقاًإنه يدير البيانات الموجودة في سجل واحد من 
الجدول مم٣Sمهه8Barc.‏ ما هو مختلف هو كود +ا60 الموجود في معالج الحدث٤٠iه2.۴٠١‏ ^۸ سه۴ .مقطع الكود الأول الرئيسي يحاول تحديد كيفية موازنة قطعة 
٠ 1‏ 8.5من الصفحة لجعلها تظهر في مستطيل صغير حجمه216.272.وهناك الكتير من الحسابات»عندما تكتملبيتم تحديد نسبة الصفحة الصغيرة إلى الكبيرةويؤدي 
إلى رسم قطعة من الصفحة على الشاشة مع الحدود وظل الاإسقاط 
رسم منطقة الصفحة 
e.Graphics.FillRectangle (SystemBrushes.ControlDark, pageLeft + 1,‏ 
pageTop + 1, pageWidth + 2, pageHeight + 2)‏ 
e.Graphics.FillRectangle (SystemBrushes.ControlDark, pageLeft + 2,‏ 
pageTop + 2, pageWidth + 2, pageHeight + 2)‏ 
E GEA RES EE TREE ang le (EE US RE SHE ESET Bagel ES GS BSL SS Gl‏ 
pageWidth + 2, pageHeight + 2)‏ 
e.Graphics.FillRectangle (Brushes.White, pageLeft, pageTop, pageWidth, pageHeight)‏ 
ومن تم وقبل رسم الحدود الخار جية للمعاينة بالنسبة لكل لصاقة مستطيلة.تعمل على إعادة موضعة مصدر الشبكة إلى الزاوية العلوية اليسارية بالنسبة للقطعة التي على 
الشاشة من الورقةءوتحويلات ميزان الكلمة بالاعتماد على نسبة قطعة الكلمة الحقيقية للورقة والصورة على الشاشة لها. 


e.Graphics.TranslateTransform (pageLeft, pageTop) 
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e.Graphics.ScaleTransform (useRatio, useRatio) 

توجد العديد من الحسابات الأخرى من أجل الحجم لكل لصاقة. متبوعة بحلقة مضاعفة(من أجل كل من الصفوف والأعمدة للصاقة) وهي تقوم بالطباعة الحقيقية لحدود 

اللصاقة (تفاصيل الحسابات تم حذفها من أجل الاختزال). 


HOE TOWSCAN = 1 TO CIRENBCROWS. THOExXE) 
EOE COLCA > LL EO CENE (ECCOLUNDS LOSE) 
le EO f SEE > 
topOffset = 
e.Graphics.DrawRectangle (Pens.Cyan, 
LE EOE SEE EOPOE i SEE, | 
oneWidthTwips, oneHeightTwips) 
ME COLSCE 
Next rowScan ۴ 
من الواضح أن الفورم اعطةاءلهء۲ه8أكثر أهمية وتعقيداً من نموذجي تحرير اليار كود.بينما يعرف النموذج موه ۴٥١١ء8 الصفيحة الكاملة للصاقات مع لاشيء‎ 
. بداخل كل لصاقة.تعرف الفورم اعطةاءله٠84ما يجري داخل كل لصاقةءييين الشكل التالي هذه الفورم مع عينة لصاقة‎ 
BarcodeLabel تٽlنlيıلll .الكثير من كودها يتعامل مع تحميل وحفظ السجلات من جداول قاعدة‎ Bهء۵‎ ٤٥0١٠۴ ١۲٣١مروفلا إن الفورم امطaاءمههء8Barأيضا مشتقة من‎ 
)»وتخزين سجلها‎ 82۲١١١6۴ .كل لصاقة بار كود مربوطة إلى قالب صفحة بار كود خاصة(والتي حددناها منذ قليل من خلال الفورم#وة‎ Barcode abel ltemو‎ 
الرئيسي في الجدولاءطة-اء هه82 .يحدد هذه الجدول أساسيات اللصاقةءمثل اسمها ونظام القياسات.نص وشكل بند موضوع على الجدول يتم تخزينهما كسجلات في‎ 
الجدول ”ء†اامabاBarcodeذو الصلة.‎ 


تجرير قالب لصاقة البار كود 


colebale سح القالب:‎ 
El Misc 
Alignment 1 
BarcodeColor 1| | centimeters القياسات:‎ 
BarcodeSize 


قالب الصفجة: copy‏ 


(Line: (O,D} bo (2.54, 1.27 بنوذ اللصاقة:‎ 


Height (Rectangle: Ak (0,0 
Left (Barcode: At (0,0 
PadDigits ¥ Text: Text 


Rotationûngle | Barcode: At ID,D 
pc mmm ETS 


Tap 


0 J E WW (J) me 


{Label Preview: 6, 773333 wj by 2.667 (h 


Width 
وضع اتساع صندوق البار وذ‎ 


عينة بار کود: |12345678 | 


يعمل الروتين glePrepareFormFields‏ تحميل سجلات لصاقة سجلات موجودة من قاعدة البيانات»منشئاً حالة فئات من الملف Barcode/e”C|lass.vb‏ 
الجديد.ويضيفها إلى أداة صندوق القائمة ك٣٠†ارهامءاص.إليك‏ مقطع الكود الذي يحمل في "صورة البار كود"(البار كود الفعلي المعروض)من مدخلة في جدول 


.BarcodeLabelltems 


"صورة البار كود 

newBarcodeImage = New Library.BarcodeItemBarcode Image 

newBarcodeImage.Alignment = CType (CInt (dbInfo!Alignment), System.Drawing.ContentAlignment) 

newBarcodeImage. BarcodeColor =System. Drawing.Color.FromArgb (CInt (dbInfo!Color1l) ) 
newBarcodeImage.BarcodeSize = CSng (dbInfo!FontSize) 
newBarcodeImage.Left = CSng (dbInfo!PosLeft) 
newBarcodeImage. Top = CSng (dbInfo! PosTop) 
newBarcodeImage.Width = CSng (dbInfo! PosWidth) 
newBarcodeImage.Height = CSng (dbInfo! PosHeight) 
newBarcodeImage.RotationAngle = CShort (dbInfo! Rotation) 
newBarcodeImage.PadDigits = CByte (DBGetInteger (dbInfo! PadDigits) ) 
DisplaylItems.Items.Add (newBarcodeImage) 
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Mhm76 

بإمكان المستخدم إضافة أشكال»عناصر نص.وبار كود إلى اللصاقة بالنقر على واحدة من أزرار إضافة بند التي تظهر تحت أداة كء»٣#اارهامءاط.كل‏ زر يعمل على إضافة 
سجل افتر اضي إلى اللصاقةءبحيث يستطبع المستخدم تعديله فيما بعد.عند يتم اختيار كل عنصر لصاقة من ك٣٠#اارهامءاط.تظهر‏ خاصياته في الأداة 
»ltemProperties‏ وهي حالة أو نسخة عن الأداة ك6 ,)ممه .تعديل عنصر لصاقة هي قضية تفير خاصياته.ييين الشكل التالي تفير خاصية اللون. 


3 Misc 
Alignment MiddleRighEt 
Gisplay¥T ext Tent 

3H Font Arial; 1ZpE 
Height 1.77 
Left 11 
RotationÃangle 1 
TE olor E DarkslateBlue ¥ 


System | 
LT LightSteelBlue 
EN ZoarnflawerEBlue 
EM FoyalEl e 
EE MidnightBl Jz 
LL 1Lavender 


EE adir Blue 

E Elı ıa 

L1 Shostwhite 

EH S2lateBluz 
DarkSlatsBlus 

EEN MediımalateBluıa 

EN MediumPurple 
Ruel 


كما مع الفورم#وة #۴ هء١ه8B‏ .تأتي المتعة الحقيقة في الفورم امطةاءهكهء82۲من خلال حدث الرسم i١‏ لاداة معاينة #W‏ ۷٠١م‏ اللصاقة. re2‏ PreviewA»وهذا‏ 
الروتين حوالي 300سطر يبدأ برسم السطح الفارغ ۴2٥٥‏ اء )اط للصاقة مع إسقاط الظل.ومن ثم يعالج كل عنصر في القائمةء٣٠٤ارةامءا‏ .واحد بعد 
الآخر.بالتالي يعمل على تحويل ورسم كل عنصر كما تشير خاصياته.عند تمرير الخاصيات من خلال قائمة عنصر.» يطبق الكود التحويلات إلى منطقة الرسم عند 
الحاجة.ولحفظ الأشياء مرتبة من أجل كل عنصرءيتم حفظ بداية السطح قبل عمل التغيرات»ويتم إتمام التغيرات المعاد تخزينها. 
ALEM GO GE O‏ 
For counter 0 EO DISGLaAV I EeMS I EEMS COUNE 2 U‏ 

E E E 1 

holdState e.Graphics.Save ()‏ 
كود الرسم الرئيسي يتم وضعه هنا. 
E O CT Ca‏ ا ر 

e.Graphics.Restore (holdState) 

NExE GEoUnNEeE 


ينجز كل كود عنصر حجوم متنوع»موضعءوتحويلات تدوير مطلوبة من أجل العرض المناسب للعنصر.لنلقي نظرة أقرب على الكود الذي يعرض عناصر النص الثابت( 
الكود الذي يتم استدعاءه لعرض نص البار كود). بعد ترتيب عرض الكلمة إلى منطقة معاينة سطح اللصاقة.يتم عمل أي تدوير مطلوب من قبل المستخدم بخصوص الزاوية 
الا الات مطل اك كط نض اة 


الرسم 


e.Graphics.TranslateTransform (Xl, Y1) 
e.Graphics.RotateTransform (textAngle) 
التاليءرسم سطر متقطع حول كائن النص لاظهار الحالة المختارة.‎ 
pixelPen New System. Drawing. Pen (Color.LightGray,l1 / e.Graphics.DpiX) 
pixelPen.DashStyle Drawing2D.DashStyle. Dash 
e.Graphics.DrawRectangle (pixelPen, X1, Y1, X2, 
pixelPen.Dispose () 


ا(2 


بعد إعداد بعض علامات تجانب النص المناسب عمودياً وافقياً ضمن حدود صندوقهاء تدفع الطريقة وا٣؛W5‏ 04 النص إلى العرض. 
e.Graphics.DrawString (textMessage, useFont, New System. Drawing. SolidBrush (textColor),‏ 
New Drawing.RectangleF (X1, ¥1, X2, ¥2), textFormat)‏ 
useFont. Dispose ()‏ 
سنعمل على تكرار كود رسم اللصاقة المضمن في الفئة اماج -اءلهءه8 نوعا ما عندما نطيع اللصاقات الحقيقية في فصل لاحق. 
الشيء الوحيد الباقي هو ربط هذه المحررات مع الفورم الرئيسي.افتح كود الفورم الرئيسية 1١۴٠١٣١‏ ١ابحث‏ عن معالج حدث 
Clicked‏ inkBarcodeLabel.LinkاAdmin.‏ وأضف له الکود التالي: 


Ei va tê CUD AAI REIN EBAEEOde La Sel Min El eked (Eyal Sender 2S OO ee, bal & aS 


System.Windows.Forms.LinkLabelLinkClickedEventArgs) Handles AdminLinkBarcodeLabel.LinkClicked 


© ق ر اک ت ا کک 
If (SecurityProfile (LibrarySecurity.ManageBarcodeTemplates) = False) Then‏ 
MsgBox (NotAuthorizedMessage, MsgBoxStyle.OkOnly Or _‏ 
MsgBoxStyle. Exclamation, ProgramTitle)‏ 
Return‏ 
End Lf‏ 
رر السجلات 
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ListEditRecords.ManageRecords (New Library. BarcodeLabel) 

ListEditRecords = Nothing 

End SUS 


.ListEditR cords .فكوده مطابق لهذا الكود ما عدا حالة أو نسخة الفئة إلى‎ AdminاinkBarcodePage.‎ in) افعل المثل مع معالج حدث 4ء ءا‎ 
Eri vate SUS AMIRI NKEAEEOdeEaEGeE LINKClTcCKedKEYUSL Sender AS Oo ect, EBYUal ê AS 
System.Windows.Forms.LinkLabelLinkClickedEventArgs) Handles AdminLinkBarcodePage.LinkClicked 
دع المستخدم رر فاتمة صفحجات االمتار كوت‎ 1 
If (SecurityProfile (LibrarySecurity.ManageBarcodeTemplates) = False) Then 
MsgBox (NOtAUtROrIzedMessage, MsgBoxstyle.OkOnly OF | 
MsgBoxStyle. Exclamation, ProgramTitle) 
Return 
Emel E 
عجرتزر ال حاط‎ 
ListEditRecords.ManageRecords (New Library. BarcodePage) 
ListEditRecords = Nothing 
BENA SUS 


ليس كل ال يخص أشياء الرسم الحقيقيةءتستطبع أن تحصل على بعض المتعة.دعنا نعمل تفير ات على الفورم"حول المشر وع 46011۶۶09۲2.۷06 "والتي تتلاشى 
عندما ينقر المستخدم على الزر إغلاق٥ءه!اح‏ .وهذا يتضمن تبديل خاصية الغياش راأءةم0بحيت تزداد الشفافية ١٥73‏ 2۲۴م5ه۴بيطء بالنسية للفورم.من وجهة نظر 
كودك.فليس هناك +ا6G0مضمن.ولكن‏ ما يزال مضمن من خلال الكود المخفي والذي يستجيب على خاصية الغباش(أو اللاشفافيةراأءهم0 ).افتح الكود المصدري لهذم 
الفورم.وأضف الكود التالي إلى نهاية معالج حدث تحميل الفورم a.L02dثAboutProgr.‏ 
على الرغم من أن هذه العبارة ضرورية»وجدت أن الفورم تميل لأن تومض قليلاً على الأنظمة عندما تنتقل اللاشفافية من 1.0(100%)إلى أي شيء أخر(99%أو 
9 .في هذه الحالة).هذه الومضة كانت أقل ملاحظة عندما عملت المقطع الانتقالي أثناء معالجة التحميل. 
في معالج حدث نقر الزر إغلاقء‌iا٤.هءها٤اء۸‏ .اعمل على تضمين هذا الكود : 
"تلاشي الفورم 
Dim counter As Integer‏ 
HOE GCOUnNEeEE O0 TO LO SECS 20‏ 
Mea Opal Ey > COUREeE / TOO‏ 
Me.Refresh ()‏ 
Threading. Thread.Sleep (50)‏ 


MExE GOUNEEeG 
Me.DialogResult = Windows.Forms.DialogResult.Cancel 


يعمل هذا الكود على إغلاق الفورم بشكل متلاشي خلال ميلي ثانية.في خمس خطوات متميزة.لذلك فإن الفورم لايتم إغلاقها بشكل مفاجئ قبل التلاشي »افتح مصمم 
الفورم»اختر الزر "إغلاق ھs٬ActCI‏ "وغير خlëصuته .None gJ|Dialog Result‏ 

شيء أخر لم نعمله أبداً وهو وضع الأيقونة الرئيسية للتطبيق.على الرغم من هذا ليس بالضبط فإنه يتضمن عرض غر افيكءوالتي تؤثر بإدراك أو تقبيم المستخدم لنوعية 
البرنامج.عملت على تضمين أيقونة مسماة ٥0٥/.۸٥#0في‏ مجموعة ملف المشروع.افتح خاصيات المشروع»اختر تبويب تطبيق ١0اه‏ امم۸ »واستخدم حقل الأيقونة 
conالاتصفح‏ والبحث عن ملف ٥۵۸۰/٥٥‏ . 

أثناء تجريب الأيقونةلاحظت أن النافذة المنتشرة تظهر (مع أيقونة الفيجوال أستوديو الافتراضية) في شريط مهام ويندوز.في الحقيقةءكل فورم مفتوحة تظهر في شريط 
المهام» على يسار مدخلة الفورم الرئيسي.وهذا ليس قياسي»وكل هذا يعود إلى الخاصية 2۲ط)كة ”!سه۸ المضمنة مع كل فورم»فعملت على وضع هذه الخاصية إلى خطاأً 
ما عدا الفورم الرئيسية ۴0۲۳ أa“.‏ 


مع الفصل التالي سنكون قد عملنا على إضافة أكثر من %95 من الكود الرئيسي للمشروع. 
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الفصل التاسع عشر:الحصر والشمولية. Mhm76‏ 

الحصر والشموlية Localization and Globalization‏ 
بخصوص محاولة توسيع جاذبية ا#2ممهتطبيقاتك الخاصة لما خلف العالم المتحدث الانكليزيةءتوفر الدوت نت ميزات تتيح لك تخصيص 2//78٥0/تطبيقك‏ في لفة أخرىءحتى 
بعد أن يتم ترجمة تطبيقك ونشره. 
تفطية جمبع ميزات التخصيص في الدوت نت سيتضمن تقويمات الفترة الإمبر اطورية والإسلاميةء وأنظمة الكتابة من اليمين إلى اليسار.يغطي هذا الفصل ميزات تخصيص واجهة 
المستخدم الأكثر شيوعاً.على أمل»أن تغريك في توسبع حدود اللفة. 


ام لم فت الات جن اة التر مات التاهة للبن د الفخارة هة اك الك فن اة لى ااذ الا في عل د فو هكات دفخة الرات 

معظم منتجاتها تم تطويرها في الولايات المتحدةءوتم كتابتها من قبل مبرمجين يتحدثون بشكل رئيسي اللغة الإنكليزيةءوتم إخراجها بواسطة قيادات تقنية ومديري منتجات يصنعون 
القرارات بالانكليزيةءويتم تسويقها بواسطة فريق مبيعات والذي يخطط مسبقاً للحملات التجارية بالانكليزيةويتم مضايقتها 9#0و0لمن قبل المنافسين 5١0نا#‏ م١0‏ والمننقدين 
tracts‏ الذين ينسفون 5اط الحوافز #5»ناه"ومزاولة الأعمال خلف كل منتج بالإنكليزية.لذلك.ما هو متاح هو أن بإمكان ميكروسوفت بيع البرمجيات إلى غير الناطقين 
بالانكليزية حول المعمورة. 

يكمن المفتاح في شمولية وتخصيص منتجاتها.يمكن لميكر وسوفت أو أية شركة أخرى أن تطور منتجات متماتلة متميزةءوحتى بلغات مختلفةء وتبيعها في اسواق كافية.ولكن سيكون 
و ا ال اة افد فقو دومن ن كوه من خلال ر ات اتن الل واا 

التعفبم (الشعو ية 216 ط66 هو غملية تحضر برفخات بحرت نفكن قبطها بسهولة نالسنة اكل موق تقافي وافة ل ب إأضافة مصطحات غرية إلى البرمخات خلال 
عملية التعميم. بدلاً عنهيعمل المطورين على تصميم التطبيق بحيث أن كل ما يتعلق بمصطلحات الاإنكليزية والعناصر الثقافية الأمريكية(مثل عرض العملة بالدولار الأمريكي)يمكن 
أن يتم بسرعة وسهولة تبديلها جميعاً بواسطة البديل الأجنبي دون أن يؤثر على عناصر البرمجيات الأساسية. 

تعمل تطبيقات ويندوز بشكل تقليدي على استخدام"الموارد" لحفظ التطبيق بشكل عام شمولي.تحتوي الموارد سلاسل نصيةصور.وعناصر أخرى غير الكود يتم استبدالها وقت 
التنفيذ بالا عتماد على اللغة النشيطة(الفعالة) والتقافة (الإعدادات الاقليمية) لنظام التشغيل. 

یا ا اعا كل انمي على وحمل واد دبالل اد اة 6ا غات اك ور اعيا فى الو ار آل افةو امل اطا فل الت تة ا الا 
أ ا الد غاا ون أة بخ ا الا ركفن عا فلات و ٠‏ خمد علا و كاف 

التخصيص(الحصر) 07ن002/221/ يعمل على إضافة الافة الغير أصلية الفعلية وعناصر الثقافة إلى التطبيق.إنه يقول في هذه الخطوة. اعمل على ترجمة لافتات فورم الاغة 
اة الم اة ل ارك فن اة الكر هة اك الفحوال اذكه خض هة )الايق كن به التطوير فقمماء اة ئ خلال أو ات خا رة هت أن ارات نس 
اها ضلا ةالصل إلى اكد الفضدرى الطرن التمكن فن اكام 

الأخبار الحسنة بالنسبة لمطوري الدوت نت هو أن ميكروسوفت أخذت على عانقها الكثير من الأهتمام بجزء التعميم١12310ا058ا9‏ .بشكل رئيسي تحتاج أن تركز على تخصيص 

لفكتو عات اماك اة نوق اة عات الأكهة باك مى الغا فهك ماد ك لك خرة غاد كه اة الف 


ملفات الموارد هي المفتاح إلى لغة التخصيص في بر امج الدوت نت.ستكتب الفيجوال أستوديو الملفات عوضاً عنك.ولكن من الجيد معرفة شيء ما حول كيفية عملهاءبما أنك تريد 
صناعة ملفات الموارد الخاصة بك(إذا كان لديك الكثير من الوقت ).تسير حياة مصدر ما في ثلاث أطوار»كما تم تحديدها من قبل نوع الملف الذي تظهر فيه. 


تيدأ موار د التطبيق حياتها في ملف مصدر الموارد.قبل الدوت نت»كانت الموارد تظهر في ملفات"صيغة المورد أمأ56 ۲50۲٠۵‏ ".والتي تدمج أفضل مافي لفة التطوير ٥و‏ 
أوامر صيغة الحالة الكبيرة »وتستخدم امتداد الملف ./٤‏ .في الفيجوال بيسك2008.تستخدم × معتمد على ملفات ./٥5×‏ .يتضمن كل تطبيق نماذج ويندوز جديد ملف 
esources.resx‏ ۴ .ینتظر أن تعمل على تعيئته بمصادر تطبيقك. 

خلف ملفات مصدر الموارد الأساسيةءيمكن أن يتم تضمين أنواع ملفات أخرى كموارد»على الرغم من أنها ستبقى مراجع من خلال محتوى الملف×ئ/.. تتضمن ملفات الموارد 
الخارجية المشتركة ملفات صورة(مثل ملفات/و. و وط/.) وملفات نصية 69.)).يستخدم مشر وع المكتبة ملف اسمه وط/.و2١//45۸/م&‏ كمورد من أجل الشاشة 
المنتشرة»وملف أخر مسمی e" L00)up08 02y.»‏ )/یحتوي محتوی 1ا۳۳۲۳یتم استخدامه عند عرض بنود من خلال الفور م 0.۷6 ۸1٥0 ۸u‏ eا/.‏ 


حالما تكون مصادر مواردك جاهزةءيتم تحويلها إلى نموذج وسيطعاة ا١٥"‏ 1"۲ »ويتم تخزينها مع امتداد ملف الموار د ئءء/٠۴50/..من‏ خلال معالجة تدعى إنتاج المورد.تعمل 
عادة الفيجوال أستوديو هذه الخطوة خلف الكواليس من أجلك.ولكن تستطبع أيضاً استخدام أداة موفرة من قيل مجموعة تطوير برمجيات الدوت نت)S50 ..٤۲‏ (تدعی 
exe‏ .رعوءe/)لنتاج‏ هذه الملفات بنفسك.تتضمن ملفات المورد الوسيطة محتوى تنائي فقط ولم يتم تصميمها من أجل الاستعراض في المفكرة. 


ملفات المورد الوسيطة لايتم استخدامها كثيرآً من أجل توزبع تطبيقك.فالمصطلح "وسيط عا 710/٣٥2/2‏ "من النوع الذي يتخلى عن الخصوصية أو يطرح الأسرار جانباً قبل 
توزيع مواردك في البرنامجتحتاج إلى أن یتم ترجمتها إلى ملف ا1٥‏ أو ٤×ع.من‏ المحتمل أنك تعلم مسبقاً أن هذه الملفات تحتوي عدة مقاطعءمتضمنة كود متميز ومقاطع 
بيانات.يحتوي ملف الموارد المترجم مقطع البيانات فقط مع الموارد.فلا يوجد كود في ملف المورد المترجم على الرغم من ذلك يمكن أن تتضمن ملفات الكود المترجمة القياسية 
أيضاً مصادر مترجمة. 

في الدوت نت.ملفات الموارد المترجمة هي مجمعات تابعة.تدعم مجمع التطبيق الرئيسي»وهي غير مفيدة بشكل عام بعيداً عن المجمع الرئيسي. 

بعض أنواع الموارد القياسية يتم تخزينها في ملفات الموارد9٭۴۶٥/.)‏ للدوت نت ك: 

سلاسل حر فیة.sو۸‏ 51 

سنركز بشكل رئيسي على موارد السلاسل الحرفية في هذه الفصل.كل مورد سلسلة حرفية يتضمن اسم وقيمة نصية. 

/”"ag9s5. الصور‎ 

يمن آن تتضمن تطبيقات الفيجوال بيسك ملفات الصور ۴G‏ ۴ل. MP و.PNG ۱۴۴ G۱۴‏ .كل صورة.كما جميع المواردتتضمن الاسم المرافق»والذي يمكن أن يختلف عن 
الاسم الأصلي لملف الغرافيك( أو الرسوميات). 


الفصل التاسع عشر:الحصر والشمولية. Mhm76‏ 
الأيقونات.۸5٣c0/‏ 

أيقونات البر نامج المستخدمة مع النماذج والتطبيق نفسه تظهر كموارد قياسية. للأيقونات امتداد ملفهء/. . 

Audios 

يمكن أن تتضمن الموارد ملفات أوديو محددةبالاعتماد على محتوی أوديو ويف ۷۸۷. 

F/عs.تافلم‎ 

إذا كانت أنواع الملفات المجدولة حتى الآن لا تلبي احتياجاتكءتستطبع تضمين جميع الملفات لأي نوع كموارد مسماة. 

فر کOther‏ 

خلف الملفات.تستطيع تخزين محتوى أي نوع بيانات دوت نت كمورد.الموارد في ملف×ئ/. هي محددة النوع بقوة بالنسبة لأنواع الدوت نتءلذلك لاتوجد حدود حقيقية لنوع 
البيانات التي تستطبع وضعها هناك.تستطبع أيضاً تعديل محتوى الملف ×ئ٥/.‏ بحيث يتضمن موارد غير قياسية .وتقع الموارد غير القياسية ٣٥١-54١02۲١‏ خلف حدود هذم 
الفصل. 

تتضمن نافذة خاصيات المشروع مدير من أجل موارد التطبيق الواسعة(شاهد الشكل التالي).تتضمن بيئة التطوير المتكاملة أيضاً محررات خاصة تتبح لك تحرير أنواع الموارد 
القباسية والعديد من أنواع الموارد الغير قياسية. 


ناقشنا هذه الكائن في فصول سابقة»ولكن كتذكير »تستطيع الوصول إلى موارد التطبيق من خلال الكائنءمءu۲مءه۷.8(‏ .إذا كان لديك مورد نص„ مڊaأ”MainFormCaption‏ « 
فإن المرجع التالي بعود ڊقيمته:1ثi My.Resources.MainForm€Capt‏ 

جميع الموارد محددة النوع بقوة.في هذه الحالة» 0nنأمCa Form‏ Mainمنj‏ نوع .System.String‏ مورد الصورة eوm2aاہءهaامكالمضمنة‏ في مشروع المكتبة يتم التصريح عنها 
كنوع System .Drawİng.Bitmap‏ .أن كل مورد محدد النوع بقوة.تستطبع استخدام المرجع هم5٠‏ 8R.ر‏ في كودك مثل أي بیانات نوع مورد تماماً. 


Application | lÎ Images ” 3 Add Resource < F4 Remowe Resource 


Lompile 
Debug 
References 
Resources 


Splashlmage 
SEIYICES 


في تطبيقات نماذج ويندوز الجديدةءتظهر جميع موارد التطبيق الواسعة في الملف ×ئع۲.ئعء/ا50ئع۴.تجدها في الدليل اءع/٠/۶‏ ,/ ضمن دليل الكود المصدري للتطبيق, 
تستطيع عرضها في المفكرة إذا أردت»وهي ملف ا×كبير نسبياً »ولاتهمني مباشرةءما عدا عملهاء إليك قسم من ملف×ء٠ع/.sئ٥ع-/01ئ٥۸‏ لمشروع المكتية والذي يخصص 
الموردين الموجودين فيه(قمت بحذف بعض الأسطر لجعله يناسب الصفحة)ولقد علمت اسم كل مورد وأنواع بياناتها المحددة بقوة. 
<data name="ItemLookupBody" type="System. Resources. ResXFileRef, System.Windows.Forms">‏ 
<value>..\Resources\ItemLookupBody.txt; System.String, mscorlib, Version=2.0.0.0,‏ 
Culture=neutral, PublicKeyToken=b77a5c561934e089;Windows-1252</value>‏ 
GEE‏ 
<data name="SplashImage" type="System. Resources. ResXFileRef, System.Windows.Forms">‏ 
<value>..\Resources\SplashImage. jpg; System. Drawing. Bitmap, System. Drawing,‏ 
Version=2.0.0.0, Culture=neutral, PublicKeyToken=bO03f5f7f11d50a3a</value>‏ 
</data>‏ 
كل فورم تضيفه إلى المشروع لديه أيضاً ملف المورد الخاص به.فمن أجل ال ٠۲۳1‏ ۴يدعى×ءع/.0//71 .هذه الملفات ينتهي بها المطاف لان تكون إضافة كبيرة في مركز 
تطبیقات نماذج ویندوز. 
خلف الستاريأخذ تطبيقك محاكاة التوجه الكائني لاإدارة الموارد.فهو يستخدم الفئة System.Resources.ResourceM anager‏ لایجاد والعودة بحالات کل مورد عندما 
تحتاجه.ونفس هذه الفئة تصنع القرار بخصوص تحديد لغفة معينة أو الموارد الخاصة بثقافة من بين الكثير من الموارد المضافة لتطبيقك وستجعلها مرئية للمستخدم. 


لايوجد معنى لتأجيل تقديم ميز ات التخصيص في الفيجوال أستوديوءبما أنها سهلة الاستخدام.لقد علمت مسبقاً ما يخص محرر موارد خاصيات المشروع الواسعة للتطبيق. بالمقابلء 
للقي نظرة على جزء مميز :تخصيص النماذج والأدوات الموجودة في محرر نماذج الفيجوال أستوديو. 

إليك تطبيق نماذج ويندوز يعمل على كتابة اسمك بشكل مقلوب» عملت على إضافة أدوات لصاقة امطهاءوأداة صندوق نص×٥80×٠٠‏ .وصندوق صورة ×۵۴80ںاا۴ كما هو مبين 
في الشكل التالي. 


| BE the name merror 


mirror? 


ومن اعمل على إضافة الكود المصدري نالي إلى الفورد: 
Bz ivazê SUS MEeREBOXL exe ERanIed NEYUGSlN Sender AS SMS EEM. OOIECE, Evel € AS SVS EON EMENEAEIS) HARGdlES‏ 
TextBox1l. e‏ 
ااعادة الرسم 
Bi CEUEeBOxX Ll. Inva la da êe ()‏ 
ENG SUB‏ 
i wells SUNOS ENCE ESSE Wee (SMVEL SENE AS COOCE, MEL © 4S‏ 
System.Windows.Forms. iT VERE) Handles EICEUreBOXL .BaInNE‏ 
رشح احخلفبة الفارغة 
e.Graphics.Clear (SystemColors.Window)‏ 
e.Graphics.DrawRectangle (SystemPens.InactiveCaption, 0, 0, PictureBox1.Width - 1,‏ 
PictureBoxl1.Height -‏ 
شر اغااة امرض 
Dim saveSstate As Drawing2D.GraphicsState = e.Graphics. Save ()‏ 
DIM Mirror Matrix AS New DE awa ma22 DBD. Matrix (ll, O, O, I, O, BiCTCUECBOxXl Hel GRE)‏ 
E LEONE = Mit EOEMaAEEÎ‏ 
رفم ال 
e.Graphics. ELDON EEE Text, TextBox1l.Font, SystemBrushes.WindowText, 1, 4)‏ 
E E ES‏ 
e.Graphics.Restore (saveState)‏ 
End Sub‏ 


عندما تشفل البرنامج.فإنه يعمل على إنشاء صورة عاكسة لما تكتبه في أداة صندوق النص باستخدام ميزات ال +601 .بين الشكل التالي تشفيل التطبيق وكتابة بعض النص في 
صندوق النص وكيف يظهر في أداة صندوق الصورة والتي تعكس صورة النص. 


El the name merror 


uapau2q 3-û 


your name: |moharnad al-mg 


mirror: 


بقدر أهمية هذا البرنامج فهو ليس معمم بالكامل ولا حتى مخصص.وعلى الأغلب شامل.كل ما نحتاج عمله لنجعله معمم بالكامل"إطلاق التحويل"على الفورم الذي يمن فيما بعد 
التخصيص.إننا نعمل هذا من خلال خاصية الفورم٠اطةاةءه‏ ا .غير هذه الخاصية من خطأً ءءاه۴ إلى صواب ٠د٣۲‏ .هل فورمك معممة!. 

الآن من أجل الجزء الثاني:التخصيص١0اة2اه۴٠!‏ .إليك الخطوات من أجل تخصيص الفورم: 

1.حدد اللفة أو ضم لغة التقافة التي تريد تخصيصها. 

2.اختر تلك اللفة أو لغة الثقافة من خاصية النموذج مود uو”ةا.‏ 

عندما تفتح قائمة هذه الخاصيةءفهي تتضمن اللغات الموجودة على نظامك.»متثل الفر نسية» العر بيةءواللغات المضمومة مع التقافة والبلد.واللغة التي تخصصها هي التي يستطبع 
المستخدم استخدامها. 

3.عدل أي خاصية للفورم أو أدواتها. 

وهذا يتم عندما يتم تفير خاصية اللفة للفورم إلى لغة غير الافتر اضية٤اه؟ه0‏ .فإن الفيجوال أستوديو تبدأ بتسجيل جمبع تغيرات الفورم والأدوات إلى ملف موارد خاص بالتقافة أو 
اللفة منفصل بالنسية للفورم. 

تستطيع تخصيص الفورم مع عدة لغات.كل مرة تفير خاصية اللغة إلى لفة أخرى أو اختيار لغة التقافةءيتم تطبيق التغيرات للفورم والأدوات فقط إلى ذلك الاختیار.ما تغیرہ یتم 
حفظه في ملف موارد منفصل. 

دعنا نجربه مع البرنامج الحالي»سأعمل على اختيار لفة تخصيص للعربية.أولاً سأعمل على وضع خاصية اللغة للفورم #وة»و ”ه1 إلى العربية.تومض الفورم بشكل لحظيءولكن 
ليس هناك ملاحظات أخرى. فهي تبدو كما في الشكل في الاعلى. 

التالي سأعمل على تغير خاصية النص للفورم ٣٠×‏ وكل أداة لصاقة إلى اللغة العربية المكافئة مع جعل خاصيات التخطيط من اليمين إلى اليسار والخاصية من اليمين إلى اليسار 
إلى صواب فستبدو الفورم كما هو مبين في الشكل التالي. 


الجزء المدهشءإذا ما عملت على إعادة وضع خاصية اللفة موهو”ه اللفورم مرةً أخرى إلى 9اuه؟0‏ )ليست اللصاقات فقط تعود الى اللفة الإنكليزيةءولكن الحقول المقابلة لها 
ستعود أيضاً إلى ما كانت عليه.على الرغم من أنني لم أراجع كل خاصية.ولكن على ما يبدو أن خاصية التخصيص تؤثر على جميع عناصر العرض لكل أداة. 
إن البرنامج الآن مخصص بالكامل إلى اللغة الانكليزية(اللغة الاقتراضية).واللغة العربية . 
عادةء الموارد العربية سيتم استخدامها فقط على أنظمة تشغيل باللغة العربية لميكروسوفت ويندوز»ولكن نستطبع إجبار البرنامج على استخدام اللغة العربية وذلك بتغير "ثقافة واجهة 
المستخدم" في كود بدء التطبيق (الروتین ما2 MyApplicaion_S‏ في الملفvh Appi cation Events.‏ )سأعمل على إضافة الکود التالي: 
Ertvale SUS MYADPIIAEAEA OM SEA EUPKEYVUal Sender AS OB ecte, Eyal € AS‏ 
Microsoft.VisualBasic.ApplicationServices.StartupEventArgs) Handles Me.Startup‏ 
TE (MSE Ox EG GO CE E N ESE ENN L7 MSGBCESEVL E OUEST ON OE MSEC SEVE ESN)‏ 
MsgBoxResult. Yes) Then‏ 
My.Application.ChangeUICulture ("AR")‏ 
ERG TE‏ 
End Sub‏ 


شغل اليرنامج الآن وجربهءولكن يجب أن يكون نظام التشغيل لديك باللغة الإنكليزية لكي يتم التبديل بين العربية والاإنكليزية وإلا إذا كان نظام تشفيلك باللغة العربية فإن الافتراضي 
أن يعمل هذا البرنامج باللفة العربية بشكل افتراضي لأنها لغة نظام التشغيل الافتر اضية.ولكن إذا كان باللغة الإنكليزية فإن يتم التبديل بين اللغتين. 


تجعل الفيجوال أستوديو التخصيص سهل جدآً.ولكن من النادر أن يكون مطور تطبيق رئيسي طليق اللسان في عدة لغات.وبالتأكيد لاتريد من غير المبرمجين من أن يتمكنوا من 
الوصول إلى نموذجك والكود في الفيجوال أستوديو»حيث يمكنهم أن يعملوا ما يعرف بالمنطق. 
لحفظ عيون وأصايع اللغة الأجنبية إلى ما تنتميءفقد كتبت ميكروسوفت محرر تخصيص موارد ويندوز »وضمنته مع مجموعة تطوير البرمجيات مع الدوت نت.(على نظامي ءيمكن 
إيجادة من اب Windows Resource Localization <<Tools << Microsoft Windows SDK v6.0A << [AII] Programsgمlربل gıoج < < Start‏ 
t۲‏ E.واسم‏ سطر أمره هو #×٥.7/5/).عندما‏ تكون جاهز على تحويل مترجم الفورم إلى لغة معينة.تحتاج إلى توفيرها لهذا البرنامج»وملف الفور×۴5/. (مثل 
۴01.٥5۸‏ ).يحاكي البرنامج عرض الفورم كما تظهر في الفيجوال أستوديو.وتسمح للمترجم بتعديل أي خاصيات فورم أو أداة مناسبة إلى لغة معينة.يبين الشكل التالي فورم 
۴1 التطبيق الذي عملناه منذ حين في محرر التخصيص. 
Windows Resource Localization Editor - [Form ] x‏ 
5y File Edit Format Winda Help‏ 


| Form1 System. Windows, Forms. Form 


(HEE 21 ا‎ 
Accessibility 
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يطلب البرنامج للغة TENT‏ أو لفة التقافة عندما تحاول حفظ التغير ات.إنه يعمل على إخراج ملف×ءء/. للفة المخصصة (مثل العر بیة ×5٥0//771.2/.۲)ءیمکن‏ أن یتم 
استخدامها في تطبيقك.حالما تحصل على ملفات الموارد من المترجمات»خز نها (الملفات»وليس المتر جمات) في دليل موارد المشروع»واعمل على إعادة بناء المشروع لانتاج 
المجمعات التابعة الصحيحة. 


الفصل التاسع عشر:الحصر والشمولية. Mhm76‏ 

من المحتمل أن تعمل على إنتاج المجمعات التابعة يدوياً من ملفات×5٠,.‏ المصدرية دون إعادة بناء كامل المشروع في الفيجوال أستوديو.سيكون عليك استخدام سطر أمر ويندوز 
.)cem”2.exe) Windows command line‏ وستحتاج إمكانية الوصول إلى ملف ۴×۴ أو اا0للمجمع.وهذا ليس لزرع القلق في قلبك. 

خطوات "إنتاج۵6١٥n‏ مو "و "تر جمةاامہہc‏ " یمکن أن یتم عملھا باستخدام خدمات سطري أمر €^ ¡ا- 2۸ OTN‏ : 

resgen. exe‏ و€eX‏ 2 .آلا بدو ذلك عظیماً؟. 

كما مع أدوات سطر أمر الدوت نت الأخرىءفإن هذه الأدوات تحتاج أن يتم تنصيب بيئة سطر الأمر ne evi ١۳8€‏ iا-andصmمc‏ المناسبة»لتضمن أن لديك البيئة 
ااك اح إلى فح فك وت ت اة سط الأميان فوع وى رمات الوت ت 56K‏ ۲٤ل‏ 5ة فوا غا عات على قتضيى إطار اللاك 
ستكون قادر على إيجاد مدخلة قائمة البدء من أجل هذا من قائمة ابداً S2٤‏ > > جميع البرامجs٣raو٥۴r‏ [١اA]‏ +¬ > > ميكروسوفت فيجوال أwتوديو2008 Microsoft‏ 
Studio 2008‏ اVisua‏ > > أدوات الفيجوال أستوديو sاھت‏ ۲ Studio‏ اaمVisu‏ > > محث أمر الفيجوال أستوديو2008 .Visual Studio 2008 Command Prompt‏ 


حالما یكون متاح لديك ملف×۶/..إما بإنشانه یدویاً أو باستخدام محرر تخصیص مورد ویندوز Windows Resource Localiza i0۸ Edi†0۲‏ .فإنك تعمل علی إنتاج ملف 
الموارد كهء ٠0ء‏ /باستخدام #×ه.”عوء١/‏ .تقبل خدمة سطر أمر مولد المورد(وهي جزء من مجموع أدوات مجموعة تطوير برمجيات الدوت نت) مدخلات ومخرجات اسم 
ملف كمعاملات نسبية له: 

resgen.exe Form1.ar.resx Form1.ar.resources 
بالطبع عليك أولاً تبديل الدليل إلى دليل المشروع كما يلي:‎ 

cd c\foreignnames 
ومن ثم اضغط انتر وذلك إذا كنت قد حفظت البرنامج في هذا المسار المحدد في الأعلى وبنفس الاسم(5٥٣2١٠وأ۴١ه؟)وإذا لم تعمل ذلك حاول حفظ المشروع في هذا المسار‎ 
الذي حددته في الا على »بعد أن تنقر انتر سيتغير لديك المسار داخل سطر الامر إلى المسار التالي:‎ 
C\ForeignNames> 

إذا أصدرت مخرجات اسم ملف.سيعمل ”۴‰9#/ببساطة على استبدال الامتداد ×۲۵5. ب €8٥801/۲ع/.‏ 
إذا كان لديك مجمعات لغة أجنيية متعددة(من أجل نماذج متعددة). اعمل على إنتاج ملفات الموارد لكل النماذج.ومن ثم فإنك ستكون جاهز لترجمة المجمع التابع. 


تستخدم الدوت نته×ه./۾ .برنامج رابط المجمع "هوام Linke‏ yاbصمءs‏ .لترجمة جميع تطبيقات الدوت نت إلى ملفات المجمع النهائي.سنستخدم نفس هذا البرنامج 
لإنتاج المجمعات التابعة.لقد تم تصميم المعاملات النسبية له بواسطة منظمة سريةءلذلك وللحصول عليها سيأخذ بعض العمل.لنلقي نظرة على الأمر أولاًءومن ثم سأشرحه. 
طعا قبل إدخال سطر الامر هذا لا تنسى أن تغير المسار ”J|‏ lلمluڙر)C\ForeignNames(‏ 
al.exe/target:lib /embed:Form1.ar.resources,ForeignNames.Form1.ar.resources /culture:ar /out:ForeignNames.resources.dll‏ 
/template:bin\Release\ForeignNames.exe‏ 


بالطبع عليك وضع هذا الأمر في سطر أمر واحد ولا تنسى الفراغات بين كل أمر:لاحظ الفراغ مثلا بين والذي لم أعمل على تعليمه(التقطيعات الصفيرة. 
الخيارات الموفرة إلى #×٠./4هي‏ التي تقوم بكل هذا السحر: 
Itarget:lib‏ 


يقول الجزء طاء"اعمل على إخراج ملف من نوع اا0 " 
lembed‏ 


يشير هذا الجزء إلى الملفات المصدرية التي تريد تضمينها في المجمع الذي ستعمل على إخراجه.الجزء الأول المحدد بفاصلة يشير إلى اسم الملف المصدريء»ينما يشير الجزء 
الثاني إلى الاسم الذي سيعرف به هذا المورد في التطبيق.ويجب أن يكون الاسم بالتنسيق:الاسم القاعدي.الاسم الثقافي. المو ار دNae.resources basename. culture‏ .حيث 
الاسم القاعدي 47٥١‏ ٥ء2طهو‏ اسم التطبيق(من أجل موارد التطبيق الواسعة) أو اسم الفئة(مكافئة لفضاء أسماءها)من أجل فئة خاصةءمثل 1١۲۳٠۴.بما‏ أن تطبيقي وفضاء أسماءه 
الأعلى الافتراضي كلاهما" كم۳ه١”واء۲ه۴‏ ".لذلك عملت على تضمينه في اسم المكون. تستطبع إضافة العديد من خيارات ١٠ط‏ ”ء/ كلما كان لديك ملفات موارد أكثر تحتاج 
leulture‏ 


على الرغم من أنك ستعمل في النهاية على وضع المجمع التابع في مجلد محدد من أجل الثقافة الهدف.فإن الفيجوال بيسك لاتثق بك.بالمقابلءفهي تريد تسجيل الثقافة المضمنة في 
المجمع نفسه.وتعمل ذلك من خيار سطر الأمر هذا. 
lout‏ 


يحدد هذا الخيار الاسم الذي سيتم إخراجه للملف التابع(أو الثانوي).في الحقيقة تحتاج إلى استخدام الاسم من أجل الملف|/ r. resources.‏ icatio0اapp‏ »حیث icati07اapp‏ ھر 
نفس اسم تطبيقك الذي قبل اللاحقة #×. .وإذا لم تعمل هذا(لم تحدد اسم الملف الذي سيتم إخراجه)فلن يعمل.حسناًءولكن بإمكانك جعله يعمل بضبط ملف تركيب التطبيق 

و cor‏ .ممص .ولكن دلك الملف مخيف نوعاً ماءولا تريد الذهاب إلى هناك. 

template 


هذا هو الخيار الذي يقول"إني اعمل على صنع مجمع تانوي»والمجمع الرئيسي ذو الصلة هو ×". 
لاستخدام المجمع الثانوي»اعمل على إيجاد الدليل الذي يحتوي على المجمع الرئيسي(۴×ع]).اعمل على إنشاء دليل ثانوي هناك وامنحه اسم اللغة أو المفتاح الثقافي للغة المستخدم 
لإنشاء | لمجمع(" ۲ه"في حالتي)ومن تم ضع المجمع التانوي الجديد في ذلك الدليل الثانوي. 


التخصيص أكثر من أن يكون مجرد كلمات على الشاشة.توجد أيضاً قضايا لكيفية عرض الوقت.التاريخ» والقيم المالية للمستخدم.الأخبار الجيدةهو أن كل ميزة ستعمل بشكل آلي إذا 
ما عممت ع2//7طه/والتطبيق بشكل مناسب.بما أن كل برنامج دوت نت يحتفظ "بتقافة واجهة المستخدم"(والتي تعاملنا معها في عينة البرنامج السابق)ءفإن لديها"تقافة عامة" 
تستخدم لمعالجة قيم الوقت» التاربخء التمويل»وأشياء أخرى معتمدة على تقافة مشابهة.إذا كنت تستخدم الطرق الأساسية مثل 0036 لاستخراج قيم التاريخ»بدلاً من عمل بحث على 
التاريخ المدخل من قبل المستخدم الإنسان»إنك تحصل على معالجة تاريخ خاص بثقافة بدون تعب.وأيضاًءإذا استخدمت تنسيقات محددة مسبقاً من أجل الطريقة (وطرق إخراج 
سلاسل حرفية أخرى).فإنك ستحصل على التنسيق الخاص بالتقافة الصحيح بدون أي جهد إضافي.دعنا نجرب مثال سريع يعرض العملة باستخدام العملة المحلية. 
اعمل على إنشاء تطبيق نماذج ويندوز جديد.سأعمل على إضافة الكود التالي إلى الف .ApplicationEvents.vb‏ 
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Mhm76 الفصل التاسع عشر:الحصر والشمولية.‎ 
EE iva Ee SMO MYA LSa EON E EAE EUS EVVEL Senders AS CBee, Eval e sS 
Microsoft.VisualBasic.ApplicationServices.StartupEventArgs) Handles Me.Startup 

TE (MSGEOS am A e A E IS a, MSIEOESSEVULE, OUES EI OR OE 
MsgBoxStyle.YesNo) = MsgBoxResult. Yes) Then 

MY IABP EA EOD CDRANIEE UL EUEE TEE ED) 
ENO TE 
End Sub 


وهذا الكود مطابق للذي استخدمناه سابقاً في المثال السابق«ولكنني İښتدeعي My.Application.ChangeUICulture Ja My.Application.ChangeCulture İi‏ (حيث أنني 
حذفت الجزء الا).وهذا يغير ثقافة معالجة السلاسل الحرفية بدل من ثقافة واجهة المستخدم. 
والآن سأعمل على إضافة الكود التالي إلى فئة الفورم. 
EE vate SUS EHOEML oad (EVUal Senders AS SMS EEMEODNEGE BEVUE CE AS SUSECEM SEVEN EAEIS) HORS KES MyYEBAS E EOS‏ 
MSEC (EOEMa ELS OO OER)‏ 
End Sub‏ 


يبين الشكل التالي نتائج هذا الكود عند تشغيل التطبيق بين النمطين الإنكليزي والفرنسي: 
WindowsA pplicationÎ IX Win dowsA pplication Î XK‏ 


S00, UU & $00.00 


1_o LL» | 


تتضمن مكتبات فئة إطار العمل ميزات معالجة الثقافة أكثر من ما عرضناه في فضاء الأسماء 0۸نأةاهطهاG.”#اءر8.تتيح‏ لك الفئات في فضاء الأسماء هذا ضبط مخرجات 
سلاسل حرفية معتمدة على ثقافة لتلبي حاجاتك.معظمها معد وموجه لمجموعات ثقافية معينة.لدذلك فلن أعمل على مناقشتها. 

ما سنفعله في مشروع هذا الفصل هو تمكين ما تبقى من ميزات الإدارة الخاصة بالزبون.تلك الميزات التي تتضمن إدارة الفرامات لازبائن السيني السلوك.والذين لا يعيدون كتب 
المكتبة في الوقت المحدد.سنستخدم ميز ات تنسيق العملة الشاملة التي ناقشنها في هذا الفصل لجعل التطبيق شامل الوصول قدر الإمكان. 


لنعمل على إنشاء فة تعرض الميزات الهامة لكل مجموعة من المدفوعات المطبقة على بند خاص مدخل.ويالطيع الكل سيتم تخزينه في قاعدة بيانات المكتبة.ولكن الاحتفاظ بملخص 
للمدفوعات بشكل مؤقت مخزنة في الذاكرة يبسط بعض المعالجة. 


أضف فئة بند جديد إلى مشر وع المكتبة»وسمهاط۷ .١١/ع۸1/1/٥‏ ”۶47/7 .وعرفها باستخدام الكود التالي: 

Public Class PaymentItem 
اا ر ا ا ت کے ا‎ 0 1 

PUDDLE TéEemlit le AS SEEING 

PuUSliIE Fal rOnNEOPYID AS ImEeger 

Public FeesPaid As Decimal 

Public BalanceDue As Decimal 
End Class 


كل حالة من هذه الفئة تعرف الغرامات المحسوبة والمدفوعات من أجل بند مكتبة معين(٠!١6†ا)وللزبون‏ الذي أعاد البند بشكل متأخر (2|رمه٥ (۴a٥‏ 


نحتاج أيضاً لمعرفة الغرامات الكلية ۴١٣65‏ اهاه المدين بها زبون من أجل جمبع الينود.حتى عندما لا نظهر جميع التفاصيل.أضف الدالة 5ه٣۴١١ءاة۴‏ اماناج إلى الوحدة 
البرمجية ۷6 Gener a/.‏ . 
Public Function CalculatePatronFines (ByVal E EO As Integer) As Decimal‏ 
کد جرف رون سات اسر اوا ت ج 
DAM SOLES E AS SEEDO‏ 


OM EBEFOE COLO BELOEHANGLEE 

1 استخراج سجلات التغريم من أجل الزبون 

SGI NEXE > GELECT SUM(EINE 2  Ea1Q) EROM EGE ONCODY WHERE EaEEON < 1 & PDSCEONID 

Return DBGetDecimal (ExecuteSQLReturn (sqlText) ) 

HE rOEHaRdI er 
GeneralError ("CalculatePatronFines", Err.GetException () ) 
Return 0@ 

El MONEE OM 


ذاخفا لل قاع الطانات قى تخ الل مى آل كع القت على تقح فاخة الاناك واأككت عله أن الكلن #ذاى قاذ فطلوسنءولن كوا "يكين قهة 
NULL‏ ". 

قبل مراجعة سجل الزبون»يجب على المستخدم أن يحدد الزبون.ويتم عمل هذا من خلال نموذج الوصول إلى سجل الزبونءنوعاً ما نموذج دخول للزبون.يتم إسناد كلمة مرور لكل 
زبونءوالتي يجب أن تكون مزودة قبل أن يتمكن الزبون من الوصول إلى سجله.يمكن للمدراء الوصول إلى سجل الزبون دون الحاجة إلى كلمة المرور.لقد عملت على إضافة الفورم 
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Pron Access. vb‏ لمشروعك»وهي تظهر في الشكل التاليءوكود هذه الفورم مشابه كثيراً للفورم"تغير المستخدم ۷6 ٥۸2٣9٥058۲.‏ ".الفورم التي توفر للمدراء إمكانية 
الوصول إلى البر نامج وأضفناها في الفصل11. تتصرف فورم وصول المستخدم بشكل مختلف قليلاً من أجل المدراء والزبائن النظامبين. 

.الزبائن النظامبين يجب إما أن يوفروا كود التعريف الخاص بهم» أو أسمهم(الاسم الأخير الكاملء بشكل اختيار ي القيمة الشاملة على الاسم الأول) وكلمة المرور الخاصة بهم. إذا 
كانوا يستخدمون اسم جزئي بدل كود التعريف»والبحث عن ذلك الاسم ينتج عنه تطابقات متعددةفعليهم أن يوفروا مدخلة أكثر دقة لأسمائهم.(إذا ما كان زبونين لديهم نفس الاسم 
فسيكون عليهم الاعتماد على كود التعريف »وکن هذا البرنامج من أجل مكتبة صغفيرةءلذلك فإن تعارض الأسماء يجب أن يكون نادر 


٤ EE‏ وصول الزبون 


الوصول إلى سحل الزبون بتنابة ات الزبون a‏ تود التجريف .لذا تم تنابة 
سم استخدم التنسبةق الأخيررالأول" 


يعمل المدراء على إدخال اسم الزبون»أو كود اتعريف »ولكن ليس هناك حاجة | 
إذا كانت هناك تطابقات متعددة لأسمءفإن الفورم تعمل على جلب جمبع الأسماء المتطابقة في القائمة»ويمكن للمدير أن يختار المدخلة الصحيحة من القائمة.وهذا يمنح المدير إمكانية 
وصول كاملة لجميع سجلات الزبون.من الواضح أهمية تسجيل الخروج للمدير عندما ينتهي من استخدام الجهاز (أو شبكة الأجهزة) التي تكون متاحة للزبائن. 

توفر طريقة ١0ء2‏ ام5 الفورم ۴210۸۸0٥655‏ واجهة الفورم لكل من المدراء والزيائن العاديين.تعود الدالة بمعرف الزبون 0|المختارءأو -1 إذا لم ينجح المستخدم في 
الوصول إلى سجل الزبون. 


على الرغم من استطاعة المدراء من تغير كلمة مرور كل زبون من خلال "نمودج الزبون ۶41/0۸.۷6 ".فلا نريد أن نمنح الزبائن العاديين إمكانية الوصول إلى تلك الفورم وكل 
محتوياتها. ولكن ما زلنا نريد أن يكون الزبائن قادرين على تغير كلمات المرور الخاصة بهمءوبما أنه شيء خاص وسري.عملت على إضافة الفورم Ww 0/2 ۷b‏ ۴210۸۳۴255 إلى 
المشروع لاإنجاز هذا الهدف(شاهد الشكل التالي). 


اسم الزبون - غير مطبق 
تلمة المرور: 
فادها ! 


[ قال شا 


Ea ك ف الا اكك اام هادان اكان ك اها اكير‎ E 
.8Sه۷۵۴٠١١٣04٤2 الزبون الجديدة والموجودة.تركيز نموذج كلمة مرور الزبون على تحديث العبارة التي تضع كلمة مرور الزبون .في الطريقة‎ 


Private Function SaveFormData() As Boolean 
SE ES RS ES 
DIM SIRES E AS ETERS 
OR EEO COLO BrTEOLHARALEE 
Me. CUESOE  WINIOWS  EOLMS . CUE SOL SMa ECUESOL 
N 
SALL EXE  UEDATE BaErON SEL [BASSWOEAl "° C&C DELEXE(ENCEYBEEASSWOEAKIDAEEONL, 
Tim (Recor dIEBas swoon d E Tere) CF 
U MMR MM = WY & MOCCASIN 
E IEEE) 
جال التحاح‎ 
Me.Cursor = Windows.Forms.Cursors. Default 
Return True 
E OEE EE 
Me.Cursor = Windows.Forms.Cursors. Default 
GeneralError ("PatronPassword.SaveFormData", Err.GetException () ) 
Return False 
En EMRE EION 


الكلمة 0/١‏ سء كلمة محجوزة في سكول سرفر 86۲۷6۲ ا50 بلذلك نحتاج إلى تجاوزها من خلال أقواس مضلعة عند الإشارة إلى الحقل في عبارات سكول. 
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في عالم مثاليءلن يسمح الزبائن أن تبقى كتبهم وبنود المكتبة الأخرى أن تصل إلى حالة فوات الميعاد.بالطبعء في العالم المثاليءسيتيح لك المكتبات الاحتفاظ بالكنب التي تحب بشكل 
غير محدد.ويريحوني من ملاحظات التأخير التسديد المتواصلة. 

ولكن من أجل تلك المكتبات الصفيرة والتي تصر على فرض الغرامات من أجل الينود المتأخرة.فإن مشروع المكتبة يتضمن ميزات من أجل إسناد وتعقب الغرامات.في فصل 
متأخر »سنعمل على إضافة الكود الذي يحسب الغر امات بشكل تلقائي من أجل البنود المتأخرة.أما الآن»سنعمل على تنفيذ الفورم التي تتيح لك توثيق مدفوعات زبون وتسويات مالية 
أخرى للبنود في سجل زبون. 

عملت على إضافة الفورم ٤١ه"‏ رة ۴ه ا۴aلمجموع‏ ملفات المشروع»ءولكنها غير متكاملة حتى الآن مع المشروع.اختر الملفط۷ ۸4 ۶10۸۶2۷/٣٥‏ في مستكشف 
الحلول»ومن تم غير خاصية ^٥0١‏ ١اا8u‏ (في لوحة الخاصيات5ها۲ممه۴r‏ ) من 0oneلإلى‏ eاpiم0mع‏ .بين الشكل التالي الأدوات على هذه الفورم. 

الغرامات التي تضاف بشكل تلقاني على بند متأخر تظهر في حقل قاعدة البیانات ۴٣۵‏ 0p۷٥۸°٥ءPa‏ .على الرغم من أن تلك القيمة يتم عرضها على فورم "مدفوعات زبون _ 
Payment‏ nد۴atr‏ ".فهي ليست التركيز الرئيسي على تلك الفورم.بالمقابل»تتواجد الفورم للسماح لامناء المكتبة من إدخال الرسوم والمدفوعات من أجل بند تم إرجاعه مسيقاء 
وتخزين هذ التحديتات في جدول قاعدة البيانات†١٠”‏ ۷ه ۸۴١٠هP‏ .يتعقب هذا الجدول أربع أنواع من أحداث التمويل من أجل كل بند تم إعادته من قبل زبون: 

.الغرامات الإضافية المفروضة من قبل أمين مكتية أو مدير .على سبيل المثال»يمكن أن يضيف قيمة ليند كفرامة إذا ما تم نتج عنه أن الزبون قد فقد (أو أضاع)البند . مدخلات 
التفريم الإضافية تستخدم الحرف في حقل قاعدة lıllنlٽ .PatronPayment. Entry ype‏ 
.المدفوعات المعمولة من قبل زبون من أجل بند متأخر الإعادة. ٣هو‏ نوع المدخلة. 
.عزل (أو صرف)بعض أو جميع الغر امات المعلقة ك6٣ا؟‏ وما١٣هم‏ من أجل بند متأخر.يتم الإشارة إليه بنوع المدخلة 2. 
.إذا كانت نوع المدخلة ۸ هو ءفإن السجل يشير إلى مدفوعات مسترجعة ٠١‏ د۲6 إلى زبون من قبل المكنبة. 


حذث تسذید جذيد 
| © يحمل الزيونا على التسديد 
تضيف المكنبة غرامات لإضافية 


المكتبة تخفض الخرامة 


| 0© تصدر المكتبة استرجاحع 
الكصية: 


كل سجل جدول ٠٣‏ ”ه۴١‏ ها ۴يتضمن تاريخ مداولة ١0ناءهء”‏ هع .كمية المداولةءتعليقات اختيارية»ومعرف(هوية) المستخدم المدير الذي يسجل المدخلة.لجعل الكود أكثر 
وضوحاً بقليلءيتم تحويل أكواد الأحرف الاأبجدية في جدول قاعدة البيانات إلى قيم عددية من lلعڏlد .EventEntryType‏ 
Private Enum EventEntryType‏ 
NotDefined‏ 
PatronPayment‏ 
FineAdded‏ 
EFineDismissal‏ 
Ref UNdJTIORBA EE OR‏ 
OverdueFines‏ 
End Enum‏ 
تسمح المدخلة Overdue Fines‏ ق Patron Copy.Fines‏ ن تكون جزء من تاريخ التمويل المعروض على الفورم. 
يستخدم أمين المكتبة الحقول في مقطع"حدث تسديد جديد" للنموذج ٤١ه٣‏ ر۴١‏ ١ءه۴‏ لإضافة سجلات المدفوعات والرسوم.جميع السجلات المضافة سابقاً تظهر في القائمة 
EventHistory‏ .في المقطع "تاريخ حدث التسديد" من الفورم. 
الفورم المستدعي(سنضيفه فيما بعد في هذا الفصل)يحتاج أن يمرر القيمة ۷.۱2م ۴4١١١٥٥‏ إلى معرف سجل مناسب.ولكن على المشروع أن يحصل على المدفوعات المضافة 
على هذه الفورم بالعودة إلى الفورم الرئيسية.كلا الفورمين سيتشاركان مجموعة من كائنات ٣٠ا١٠‏ رم۴ باستخدام الفئة التي أضفناها من عدة مقاطع سابقة في هذا 
الفصل.سنعمل على تخزينها في متفير عضو محلي كمجموعة شاملة. 
Private PaymentsOnly As Generic.List (Of PaymentlItem)‏ 
نقطة الإدخال في الفورم ستكون طريقة شاملة مسماة ayes‏ ManageP.أضف‏ ذلك الکود إلى lلiةö .PatronPaymert‏ 


EuBDIIE Su Managerayments (EYVal SateroncopyID Ae Malteger, | 
ByVal sessionPayments As Generic.List (Of PaymentItem) ) 
اكارة ادعات من آل س من‎ : 
ActivePatronCopyID = patronCopyID 
PaymentsOnly = sessionPayments 
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Me.ShowDialog ()‏ 
End Sub‏ 
تسجل هذه الطريقة رقم لنسخة زبون |١0۵‏ رإمهء-١٠١هم‏ ٥1ا‏ وجمع المدفوعات من أجل بند تم إخراجه.ومن ثم تنتقل المعالجة إلى معالج حدث تحميل 1٠۵١‏ الفورم.في هذا 
الروتين والذي سنضيف له كود إدارة التمويل المحلي أو المخصصفي الروتين0ة٥ا_ا٣ه"رة۴١١ءه۴‏ يتم عمل بحث حول واحدة إلى ثلاث طرق من خلال طريقة الكود الذي 
يحمل " التفاصيل الموج زةءاأهامك رمة٣”ناء‏ "من قاعدة البيانات.بعد السطر التالي تماماً: 


Recordl tem. Text = CSEr (QDInEOTIELe) 
أضف العبارات التي بشكل عام تنسق قيم العملة من أجل لصاقات الغرامات» المدفوعات»مختصر الرصيد التي تظهر قرب أعلى الفورم.‎ 
originalFine = CDec (dbInfo!Fine) 
RecordFine.Text = Format (originalFine, "Currency") 
RecordPayments.Text = Format (CDec (dbInfo!Paid), "Currency") 
balanceDue = originalFine - CDec (dbInfo! Paid) 
RecordBalance. Text = Format (balanceDue, "Currency") 
JADEN O CoS O 
.PatronCopy.Fine ٽlنlıبلl|l هام۴ زائد التفريم المتاخر الاصليء2اي»من حقول قاعدة‎ ١۴ باقي كود معالج حدت التحميل يحمل السجلات الموجودة من الجدول ١م" رة‎ 
في‎ S2۷6۴0۲٣ إلى الطريقة‎ ئفاكمSه۷مء‎ ٤۷٠۸۲224 فيما بعد عندما ينقر المستخدم على الزر "إضافة" لإضافة حدث تمويل جديد إلى مدخلة نسخة بند وزبونءالروتين‎ 
أغلب النماذج الأخرى التي طورناها حتى الآن.تحفظ المعلومات المحدثة في قاعدة البيانات.يحتاج هذا الروتين إلى حفظ الرسوم الجديدة أو المدفوعات في الجدول‎ 
fineAmount ٽlريفغتملl أضف الكود الذي يكتب هذه السجلات. بعد الحسابات من أجل‎ . ۴4١١٤٥ ز ائد تحديث ملخص المدفوعات والرسوم في السجلرمه‎ Patron Payment 
.SaveEventData ãêıرط¦lJl‎ „ê.paidAmount ۾‎ 
EE EET RE E TR EE TO EET 
TransactionBegin () 
SO ex E > INSEE INTO Ealr OMEaymenE (ESET ONCODY, ENE YDatey, ENE VEYE, El 
Amountê, COomMMenmE, UserID) OUTEUT TNSERTED TD VALUES CCE 
ActiveEatti oOnCOpYVID € F", GEIDATE(), " € DETexl(eRLEVCOde) CG TC, rN 
ECO ECON CHEE & ¥, ¥ C&C DELE E (EE MM (ECO CCE MEE C&C | 
SS TST E LOGIE SINUSCE LD E UT 
newID = CInt (ExecuteSQLReturn (sqlText) ) 
SALLE > UEDA BalEORCOSyY SEL Hine > | GCG FIne2mount € | 
", Paid = '" & DaildAmount & " WHERE ID = GC ACEIVEPQACEONCODYVID 
ExecuteSOQL (sqlText) 
TEARS ECE ORTON E 
عملت على إنهاء كل من عيارات قاعدة البيانات في المداولة للمساعدة على ضمان تكامل البيانات.حالما يتم تحديث قاعدة البيانات.عندها يحين وقت تحديث الشاشة(أو العرض)ء‎ 
القائمة التي على الشاشة للرسوم والمدفوعات تحتاج هذا السجل الجديد.تستخدم تلك القائمة الفئة ٤ار هاءİ١۲۳م۷عءتشكيلة عن فئة التطبيق الواسعة ة0" ]اء التي‎ 
نستخدمها عادة في أداة صندوق القائمة×٠18ءاا .ل ٣۳ء†اراهاء١n†۳مvعحقول والتي هي خاصة بمعلومات التمويل المعروضة في صندوق القائمةر۲هاء۸۲۸İ٠K۷ .أضف الكود‎ 
ويضيفه إلى القائمةر۲هاء۸۲۳İ٠۷ع .مياشرةً بعد كود تحديث قاعدة البيانات الذي أضفناه منذ قليل.‎ Event Histor را٤‎ e" الذي بيني سجل‎ 
E CD NN 
historyItem = New EventHistoryItem 
historyItem. PaymentID = newID 
historylItem.EntryDate = Today 
historyItem. PaymentAmount = CDec (RecordAmount. Text) 
historyIlItem. Comments = Trim (RecordComment. Text) 
historyItem.EntryType = entryType 
EventHistory.Items.Add (historyItem) 


هذا الكود متبوع بكود مشابه يحدث القائمة را" Payne s0‏ .ال 6eneric.List)0f Paymentltem)‏ التي تم تمريرها من الفورم المستدعي.إما يحدث الكود سجل المدفوعات 
الموجودة أو يضيف سجل جديد إلى القائمة الشاملة. 


E‏ مدفوعات جدرلدة 
scanPayment = New Paymentltem‏ 
scanPayment.PatronCopyID = ActivePatronCopyID‏ 
scanPayment. ItemTitle = RecordItem. Text‏ 
scanPayment.FeesPaid = paidAmount‏ 
scanPayment. BalanceDue = fineAmount - paidAmount‏ 
PaymentsOnly.Add (scanPayment)‏ 
قبل مغادرة الدالةنحتاج إلى تنشيط قيم ملخص التمويل الثلاث قرب أعلى الفورم» التي نعمل على وضعها عندما يتم تحميل الفورم للمرة الأولى.أضف هذا الكود بعد تحديث القائمة 
.PaymentOnly‏ 
ER aE E E‏ 
RecordFine.Text = Format (fineAmount, "Currency")‏ 
RecordPayments.Text = Format (paidAmount, "Currency"”)‏ 
RecordBalance.Text = Format (fineAmount - paidAmount, "Currency")‏ 


القائمة راه†ءİ١۳ممvعهي‏ أداة حامل رسم لسطر متغير الارتفاع»مشابهة لما صممناه في الفصل 18ءيعمل حدتها ۳٠ا٠۲‏ uءة6على‏ وضع ارتفاع كل بند قائمة(تظهر التعليقات 
على السطر الثاني عندما يكون متاح)ء ومعالج حدتها ٣ءااسه0۲يعمل‏ الرسم الفعلي لكل عمود بيانات ولكل التعليقات. 


تتيح فورم مدفوعات زبون ۴2۲٥١۸ ۴4۷١6١٤‏ لأمين المكتبة من إدخال غرامات ومدفوعات مستقلة»ولكن مايز ال البرنامج بحاجة إلى فورم تدير جميع المدفوعات والغرامات 
من أجل زبون واحد. الفورم التي تعمل على إظهار فورم مدفوعات زبون عند الحاجة.تنجز الفورم"سجل زبونط0/2.۷٥٤ ۶21/07۸٥‏ " هذه الحاجة.عملت على إضافة هذه الفورم 
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إلى المشروعءعلى الرغم من أنك بحاجة إلى تمكينهاءكما مر من قبل اعمل على تمكينها كما مكنا الفورم السابقة(بشكل عام هذا للتتعلم كيف تعطل وتمكن فورم فإني عملت على 
تمكين كل النماذج في المشروع). 

وهذه الفورم متاحة لكل من المدراء والزبائنعلى الرغم من أن بعض الحقول مخفية عن الزبون. 

يقود زر"كلمة المرور 0۲١‏ سه۴ "إلى الفورم"تغير كلمة مرور الزبونك0۲س5ءه۴a ۴a0‏ مومcha‏ " التي أضفناها سابقاً في هذا الفصل.الزر "تحریر ٤d٤‏ ".متاح فقط 
للمدراءءيوفر إمكانية الوصول إلى كامل النموذحط۷ .۶4/0/7 . يعرض المقطع الرئيسي لسجل الزبون قائمة بجميع بنود الزبون التي تم إخراجها.وهي تتضمن الزر"تجديد 
"Renew‏ والذي يتيح للزبون تمديد تاربخ الإعادة من أجل بند تم إخراجه.سنعمل على إضافة الكود من أجل تلك الميزة في فصل لاحق. 

تعرض الفورم أيضاً ملخص لجمبع الغر امات المعلقة والمدفوعات.بيين الشكل التالي تبويب الغفرامات وحقوله. 


الاسحر: غیرمتاح الاسر غیرمتاح 


گود التجريغ غيرمتاح كود التجريف غيرمتاح 


قاري الاعادة 


يعمل الزر "طباعة بطاقة الرصيد" على إتتاج وصل مطبوع لجميع الغرامات والمدفوعات من أجل زبون ما.وسنعمل على إضافة كوده في فصل لاحق. 
معظم الكود في هذه الفورم موجود لادارة الغرامات والمدفوعات.لاضافة رسم أو تسديد.يختار أمين المكتبة بند من قائمة الغرامات»ومن ثم ينقر الزر"الغرامات والمدفوعات". وهذا 
يحضر الفورم"مدفوعات زبون "التي أضفناها للتو.القائمتين الرئيسيتين على فورم "سجل الزبون" لا يستخدمان الفنة القياسيةةة0٣٠†ااءا‏ »ويستخدمان فة مناسبة أكثر لدعم 
العرض الضروري لكل قائمة.وسنعمل على إضافة هذه الفئة "ء†|ااهأه ١0‏ هءاج ۴ كفئة عامة بما أنها(كما سنرى في الفصل القادم)ستستخدم في مكان أخر أيضاً في مشروع 
المكتبة.اعمل على إنشاء فة جديدة سمهاط۷.١٠‏ !ان06١‏ ١ج۴‏ .واستخدم الكود التالي من أجل محتواها. 
Public DetaillD As Integer‏ 
BUSIIE Mm E leNexzE AS SELIG‏ 
Public DueDate As Date‏ 
Public FineAmount As Decimal‏ 
Public PaidAmount As Decimal‏ 
Public BalanceDue As Decimal‏ 


والآن ارجع إلى الفورم"سجل زبون".كما ترى تعرض قائمة "الغر امات" عدة أعمدة لقيم العملة.لنعمل على إضافة الكود والذي ينسق بشكل صحبح العملة تبعاً لإعدادات العملة 
المحلية(أو الاقليمية). أولاء ابحث عن الطريقةءه١:۲۴٣٠"٣رة۸۴ءهء؟هR‏ .يعمل هذا الروتين على إضافة جمبع الغرامات والمدفوعات ويعرض النتيجة من خلال أداة اللصاقة 
"الرصيد الباقي المستحق". 

أعلى هذا الروتين تعليق ينص على "نظف القائمة الحالية".أضف الكود التالي بعد هذا التعليق: 


E EN OLEN GES 
Fines. Items.Clear () 
totalBalance = 0@ 
BalanceDue.Text = Format (0@&, "Currency™") 
Me .CUESOE  WINIOWS . EOLMNS.CUESOES WAI ECUESOL 
کقاعدۃ تنسیؤ‎ " Cu ا٣٣٤‎ " مع‎ "۴٥٣٣۵٤ يمكن أن تكون لدينا مجموعة حقل"الر صيد الباقي المستحق" ک"50.00“ "ولکن لن یکون هذا معمم بشکل مناسب.باستخدام الدالة"‎ 
ولكن تبقى تعرض النتائج بالتنسيق" 50.00“"كما ترى بما أنني استخدم على جهازي كواجهة اللغة الإنكليزية والعملة المخصص هي الدولار»ولكنها تضبط بشكل مناسب التنسية‎ 
من أجل الثقافات الأخرى.‎ 
كل تحزيم الحسابات»وتنتهي بالرصيد المتبقي المستحق على زبون في المتغير المحليءء١هاة8|هاه) . .اعمل على إيجاد التعليق الذي‎ Refresh Paرصم‎ ٤۴:٣٥5 تعمل الطريقة‎ 
ينص على " إظهار الرصيد الكلي".وأضف الكود التالي بعد هذا التعليق تماماً.‎ 
'إظهار الرصيد الكلي‎ 
BalanceDue.Text = Format (totalBalance, "Currency"™) 
ActFinePay.Enabled = False 
نماisاااء‎ 024 هاه ۴بدل القائمة القياسية‎ ١0 ه†ةنا|t٠" في قائمة الغر امات.تنفيذ حامل رسم صندوق القائمة×٠18ءاا ءيعرض أيضاً قيم العملة.وتستخدم القانمة الأخرى الفئة‎ 
أجل إدارة بنودها.اعمل على إيجاد الطريقة ١٣ء ا5_50۲۷٠٣۴ » والتعليق "استخر اج التفاصيل من بند قائمة" ضمن هذه الطريقة.وأضف الكود التالي بعد التعليق.‎ 
dal GG LN NT 
itemDetail = CType (Fines.Items (e.Index), PatronDetailItem) 
titleText = itemDetail.TitleText 
fineText = Format (itemDetail.FineAmount, "Currency"™) 
paidText = Format (itemDetail.PaidAmount, "Currency") 
balanceText = Format (itemDetail. BalanceDue, "Currency™") 
If (itemDetail.BalanceDue = 0@) Then useNotice = useBrush 
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ينسق هذا المقطع كل قيمة عملة, بشكل افتر اضيء كل القيمة العاندة تظهر باللون الأحمر في القائمة.السطر الأخير في هذا المقطع من الكود بجدد اللون إلى لون بند القائمة 
الحيادي(العادي) إذا لم يكون هناك رصيد عاند. 


بقي علينا تمكين إمكانية الوصول إلى النماذج الخاصة بزبون من خلال فورم المكتبة الرئيسي.كل ما نحتاج عمله هو إضافة معالجح حدث من أجل الزر"زبون" 


لعرض سجل الصكتبة من أجل زيون انقر الزر زيونا... 


حدد معالج حدث النقر )نا_١‏ ٥ا۴ ActAccess‏ على هذا الزر في الكود المصدري لهذه الفورم.ومن تم أضف الكود التالي لمعالح الحدث هذا. 
Eri vaEe CUS AEENCSESSEAEEON CINE EVM SENISE AS OCONEE, EVO E A. OVSECME EVEN EREGSS) HOMIES‏ 
ActAccessPatron.Click‏ 
[ اه حن حل الزن الل 
Dim patronlD As Integer‏ 
1 اا و ا 


patronlD = (New PatronAccess) .SelectPatron () 
TE (PaeronlD >= 1) Then ReEUIN 
إظهار سجل الزبون‎ 
Call (New PatronRecord) .ViewPatronRecord (patronID, True) 
End Sub 


يعمل الكود استدعاء مباشر إلى كلا النموذجين اللتين عملنا على إضافتهما في هذا الفصل:"وصول الزبون" و"سجل زبون".في البداية تظهر الفورم "وصول الزبون" لاختيار سجل 
الزبون»ومن ثم تعرض تفاصيله من خلال الفورم"سجل زبون". 


لنعمل تغير أخر بخصوص سجلات الزبون.عملنا على تضمين الز ر "إدارة بنود زبون" على فورم "الزبون۷6 .۶2/07 ".ويوجد هذا الزر لتوفير إمكانية الوصول إلى الفورم 
المستقیلي 'سجل ز بون ۶21/07۸۴٥٥0۲۵۷6‏ 'ولکنھا ما تزال حمل ثقیل حتی الاآن.ولکن مع فور مسجل الزبون ط۷ ۶0۸۸٤۴٤0/۵.‏ " الجاھزة.فنحن جاھزین لصنع تاریخ 
إدارة زبون. 
افتح الكود المصدري للنموذج" الز بون ط۷ ۶41٥.‏ "واعمل على إیجاد معالج الحدث " )اا _ء٣teاAct‏ ".ومن تم أضف الكود التالي له. 
Call (New PatronRecord) .ViewPatronRecord (ActiveIlD, False)‏ 
هذا كل شيء.ولكن ومن المحتمل أنك تفكر بنفسك. "تسمح لك نمودج الزبون الآن فتح نموذج سجل زبون.وتلك الفورم لديها زر "تحرير"يتيح لك مرةٌ أخرى فتح فورم الزبون. وإذا 
ما كان أمين المكتبة وغد.فهناك الملايين من نماذج إدارة الزبون على الشاشة في الحال.)وهذا صحيح تماماءلذلك كان علينا إضافة بعض الكود لمنع ذلك من الحدوث.المعامل النسبي 
التاني"خطأً" بالنسية للعلامة Patron Record .ViewPatron Record‏ تقول"لاتظهر الزر "تحریر "على فورم"سجل الزبون".وبشکل مشابه یوجد کود في فورم"سجل زبون" تعمل 
على إيقاف التكرار المستمر. 
ار ماد الل 
If ((New Patron) .EditRecordLimited (ActivePatronID) <> -1) Then‏ 
تخفي الطريقة 6۵ا¡" 0۲۹1ء di1۸ e‏ ۴ز ر "إدارة بنود زبون" على فورم" الز بون ط۷ ۶1/0٥/۸.‏ ".مهما تكن الفورم التي تبداً بهاءتستطيع الوصول إلى الفورم الأخرىءولكن لن 
تكون قادر على إنتاج نسخة جديدة من الفورم الأولية.كان بإمكاننا عمل تغيرات تقافية أكثر .على سبيل المتالءعمود"تاربخ الاعادة" في قائمة"الينود المخرجة" على الفورم"سجل 
ز بون ۷۵ ۶41۲0۸۸۴٥٤0/۵.‏ " تستخدم تنسیق بیانات تابتة(لایمکن تفیرھا). 
dueDate = Format (itemDetail. DueDate, "MMM d, yYyyy")‏ 


كان بإمكانك تغير هذا التاريخ القصير أو أي إعداد تقافي محايد آخر. 
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الطباعة وہ Pi)‏ 


ينفذ ينقد ویندوزر نظام من المشغلات e‏ الخاصة بالطابعات printer-specific drivers‏ والتي تحمي المبرمج من معظم تنو عات الطابعات. 
N‏ المشغلات تتکلم جمیعها لغة مشتركة _ لندعوھا'الطبعةہوااہPri‏ " والتي يتر جمها المشغل ضمن اللسان الأصلي للطابعة 
.وکمبرمجین»نحتاج فقط إلى تصمیيم البرمجيات التي تتکلم "!lطıعPrintishã‏ ".يعمل نظام الطباعة في إطار عمل الوت نت علی إضافة مستوی 
أخر من ترجمه ة اللغة.حيث أن برامج دوت نت لا تتصل مباشرةٌ مع مشغلات الطابعة. بدلا عنه»ءتستخدم GDI‏ والأوامر commands‏ نفس 
الأوامر المستخدمة لتحديثات الشاشة ‏ لاستخراج محتوى إلى رسومات طابعة في الذاكرة.يعمل إطار العمل بعدها على تحويل هذه الأوامر إلى 
طبعة ويرسل المخرجات إلى مشغل الطابعة المناسبة.وأخيرا إلى الطابعة.يبين الشكل التالي ملخص للخطوات المستخدمة في الطباعة في الدوت 


= > n 
fsa 


Application Printish Driver Printer 


للشاشة والطابعة مخرجات ناتجة من خلال نفس ا60 والأوامر بحيث من الممكن أن أجعل هذا الفصل قصير جدآءمع الإشارة إلى الفصل 18 
للمزيد من التفاصيل.ولكن هذا يعني أيضاً أن هناك حاجة لأن تكون لوحة — System.Drawing.Graphics jil‏ - حيث أن الطابعة أو ) GDI+‏ 
5ئaصmصoد‌c)‏ تستهدف مخرجات لهذا الکائن.توفر لك النَةًَ system.Drawng.Printing.PriNİDocumentلوحة‏ مخرجات تحتاجھا لکل من 
مخرجات الطباعة العادية ومعاينة قبل الطباعة. 
توجد ثلاث طرق لاستخدام فئة "طباعة مستiد printDocument‏ " 
© أضف أداة عة üwnڌiأ PrintDocument‏ : إلى نموذج من صندوق ادوات نماذج ويندوز.تظهر هذه الأداة بشکل افتراضي في مقطع 
الطباعة ا الأدوات.اسند لها خاصيات ومجيبات أحداث كما مع أي أداة أخری. 
© أنشئ متغیر (حقل)علی مستوی حالة(ذ نسخة) من فئة "طباعة مستند PrintDocument‏ ' ضمن عبارة في التعريف أتحصل علی هيئة 
الحدث. 
٠‏ انشئ حالة(نسخة)محلية من "طباعة مستنداہ مہ ں0 اہم " واربط أي حدث باستخدام إضافة معالج rماd .Add Han‏ 
إن هذه طرق قياسية في الدوت نتءولكن التنوع الذي تملكه أداة ما يجعل الفئة أكثر ملائمة.سندخل ضمن كود طباعة فعلي بعد قليل. 
"حوار إعداد انصفھؤpageSetupDialog‏ " 
تقدم هذه الأداة حوار إعداد طابعة ويندوز قياسي توفر للمستخدم إعداد عمل طباعة خاصةءأو جميع أعمال الطباعة لاتطبيق.تعرض الطريقة 
"إظهار الحوار ShowDialog‏ "للأداة نموذج مبین في الشكل التالي .تعرضص الأداة أيضاً خاصیات مرتبطة باختیار المستخدم .تعرضص أعضاءها : 
ا خاصة تحدیدها على CS‏ تحدد ا ا "الطابعة المختارة وخاصياتها. 


Mhm76 الفصل عشرون:الطباعة.‎ 
Page Setup 1 


Paper 

Size: 
Source: û,atomatkically 5 elect 5 
Urientatiaon Margins [inches] 

@ Portrait Left: 1 Bight: 1 

O Landscape Top: 1 Bottom: 1 


lL OK | [_ Caneel | 


"حوار طباعةً وەاھPrin†D¡i"‏ 
يظهر الشكل التالي حوار هذه الأداةءالحوار القياسي الذي يظهر في معظم البرامج عندما يختار المستخدم أف Print <<File‏ أمر قائمة طباعة. 
وتعرض هذه الأداة أيضا أعضاء"إعدادات الطابعة وو ناا ه۲5ه) :م " المستخدمة لإسناد أو استخراج الطابعة المختارة والخيارات المرتبطة بها. 
Print‏ *# 
General |‏ 


Select Printer 


2ã Perfect PDF Creator‏ إضافة طابعة اتا 
hp LaserJet 1010 dı Send Ta OneNote Z007‏ 
Microsoft *#PS Document writer‏ 2 


Status: جاشز‎ [] Print to file 


Location: 


Cormrnent: Find Printer... 


Page Range 
اخ ده‎ Humber of copies: | 1 چ‎ 


ior‏ 21 |2 ا 
Lollate 8 1|‏ 
8 عا 1 


Print PreviewDialog""‏ حوار معاينة قبل الطباعة" 

یعرض حوار هذه الأداة معاينة قبل الطباعة لمستندك المطبوع للمستخدم.وتتضمن مواصفات تقیدیم معاينة قياسية من ضمنها قيمة العدسة 700۳ 
ااا ا أك رار رهد در ل روا ع وو ار ارا اوك عل رو م قلاات او ن 
السؤال عن الطابعة المختارة).تتفاعل هذه الأداة مباشرة مع نسخة "'مستند الطباعة PrintDocument‏ 1 الخاص بك»٬والذدي‏ يقود محتوی العرض 
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0 rf - 
DO MB E EM | Cos: | 


تحتوي أداة "حوار معاينة قبل الطباعة PrintPreviewDialog‏ مواصفات إدارة معاينة قبل الطباعة الأساسية(مثل ميزة العدسة)والتي تلبي حاجات 
مغظم التطقات. لسرء الحظإن لادا محاظة يصتفرق اسر دعر لاتستطيع رة إضافة مو اغات خاضة ك لها أ إزالة المراضفات التي 
لاتريدها. توفر الأداة" اPreviewContro Print‏ "و اجهة بديلة والتي تسمح لك من أن تخصص بالكامل اختبار معاينة الطباعة.بدلا من صندوق 
الحوار الكامل المبين في الشكل السابقءفإن هذه الواجهة تعالج فقط القسم الذي يعرض الصفحة فقط من الفورم .يجب عليك أن تعالج جميع 
الأشرطة الأدرات رالمير ات الأخرى :تر بط تخضضها الرظفى مع اذ المحيدة قل الطاغة ان اشر هد الأداة فى هذا الفضل . 
قبل أن تطبع»ءتحتاج لمعرفة أي طابعة يريد أن يستخدمها مستخدمك لطباعة المخرجات»ءومن المحتمل أن تحتاج لمعرفة المواصفات المتاحة 
للطابعةءمثل دعم الألوانءفإذا كنت مبرمج فيجوال بيسك6ءفقد كنت معتاد على مجمع طابعات مريzحcollection convenient Printers‏ .إù‏ غياب 
معsenطمذلك‏ المجمع في فيجوال بيسك2008 يعني أنه يجب علينا وسائل أكثر غير مباشرة للوصول إلى الطابعات. 
تتضمن اة وہ¡ inter Se‏ P.وPrintin.وstem.Drawinرs‏ مجمع متغير نصي متشارك للطابعات التي تم تثبيتها والذي يجدول مسار كل طابعة 
مركبة.بامكانك إسناد أي من هذه النصوص إلى عضو "اسم الطابعة مهل مانم " "لإعدادات الطابعة 'ووہiام۲Sهtمإم‏ "٬لجعل‏ طابعة ما متاحة 
ضمن اقيق مك كرد الى سح التحدم من اشيال من قاف الطاات ريرض بن المعطومت الإساسة حول اة لنم ` 
IE CIS MO‏ 
Private Sub Buttonl1 Click (ByVal sender As System.Object, ByVal e As System.EventArgs) Handles‏ 
SEE GML SCTE‏ 


Private Sub Forml1 Load (ByVal sender As System.Object, ByVal e As System.EventArgs) Handles 
MyBase . Load 


End Sub 
End Class 


رأيت مسبقا أن العديد من مكونات ويندوز تعمل مع بعضها لتوليد مخرجات الطباعة.ضمن كودك للدوت نت»ستستخدم أيضا العديد من 
المكونات(الفئات) لقيادة معالجة الطباعة.يتم تضمين أربع خطوات رئيسية(بشكل مباشر على الأقل) في طباعة مستتد من ضمن كودك: 
1. إنشاء نسخة(حالة) من فئة "طباعة مستiد PrintDocument‏ "(أو إضافتها كأداة لنموذجك). 
2. وضع إعدادات الطابعات المتنو عة ل"طباعة مستند ٤م‏ صں‌هD‏ ہزم "»إما باستخدام "حوار الطباعة وم‌اه‌اطاہ نم "(أو ما يتعلق 
ب)الأداة/الفئةءأو باستخدام الافتراضي أو عمل إعدادات يدوية. 
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3. إضافة معالج حدث "أطبع صفحة موو امم " ل"مستند الطباعة ءام مصںءه صانم ".هذا الحدث يتم استدعاءه مرة لكل 
صفحة»ويستقبل كائن من أجل لوحة الطابعة وو۷مهء ۲١نا‏ مءيطبع كود معالج حدثك صفحة مفردة»ويحدث ادلم ںإشارة تخبر فيما 
إذا يوجد صفحات أخرى أكثر للطباعة. 
4. استدعاء الطريقة "طباعة ازم " ل"طباعة مستند امه امم " لبدء عملية الطباعة والدوران. 
لنجرب كود صغير لرؤية كيف تبدو عملية الطباعة.وكيف سيبدو الحال فيما يخص برنامج يطبع مستند من خمس صفحات على طابعة المستخدم 
المختارة؟ستكون المخرجات عدد كبير من الصفحات الرقمية المفردة مط" موهم اأوال-هاوہاء موءه| ءأولاءلنعمل على إنشاء تطبيق ويندوز 
جدید Windows Forms appاi‌ati o‏ newہ‏ »ونعمل علی إضافة زر وحید ۸٥ا‏ ںطإلی ۴۵٥۲1‏ ولنمنحه اسم ۲٣ا۴٥‏ وسنضیف أیضا أداة 
(Counting Doc)lgawi gPrintDocument‏ Îدöl‏ و اDia Print‏ نسمها(rعintمrPهوU)‏ يبين الشكل التالي النموذج والأدوات المزود بها(بإمكانك ترك 
الأسماء الافتراضية لهذه الأدوات كما هو مبين في الشكل التالي) . 


Form] 


17 BE 
êy PrintDocumernt1 LA PrintDialogl 


تنفذ هذه الأدوات أول خطوتين من الخطوات الأربع لمعالجة الطباعة.وفيما يلي سوف نعمل على إضافة الكود المصدري. 


EUS CUASS HOE 


Private SUSI BUEEORL CITE BYVEl Sender AS System. OBI EE Evlel E AS SVSEOM EVEN EATEIS) HORIIES 
BUEEONI CI ER 


End SUS 


Eri va Ee US COUN EINGDOS BEGINNER EBVVUaAN Sender AS OI eCE, | 
ByVal e As System. Drawing.Printing.PrintEventArgs) Handles PrintDocument1.BeginPrint 


End Sub 


Er iva Ee US COUR EINGDOE EE IMEEAGE NEYVEN SENISE AS OEE, 

lel © 4S SME CE De IME. EE REE |_| 

PrintPageEventArgs) Handles PrintDocument1.PrintPage 
چ‎ Print a single page. 
Dim hugeFont As Font 
Dim centeredText As StringFormat 
ج ا‎ Let's go overboard on the font: 256 points! 
hugeFont = New Font ("Arial", 256) 
ت ا‎ Center the text on the page. 
centeredText = New StringFormat () 
centeredText.Alignment = StringAlignment.Center 
centeredText.LineAlignment = StringAlignment.Center 
حص ا‎ Print the number. 
e.Graphics.DrawString (CStr (WhichPage), hugeFont, 
Brushes. Black, e.MarginBounds, centeredText) 
ي‎ Draw the page margins to make it clear where 
' they are. 
e.Graphics.DrawRectangle (Pens.BLlue, e.MarginBounds) 
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حص ل‎ Limit the output to five pages. 
WhichPage += 1 
TE ma eREage SS GS) MhMen e HASMOESEAIES EE J 
Else e.HasMorePages = False 
End SUD 


o Clecs 
ينقد هذا الكود الخطوة lلllڈ)Button1_C11ck ( والخطوة الرابعة )countingDoc_PrintPage(.يربط معالج حدٿث نقر الزر‎ 
المستند tممصuعمه وحوار الطباعة وم اهال ٤ذ٥ لذلك فإن كلاهما يشيران إلى نفس الإعدادات.ومن ثم يطلب معالج الحدث‎ Bu ton1 .c11 ck 
هذا هن السككم اخقان طا عة و الخارات الس ن خلال امت غا "طهر الران وماداو دة" فا تر التق الزن رفن ن عل‎ 
. لمعu صندوق الحوار هذاءفإنه يعمل على إطلاق استدعاء لطريقة "طباعة نمم" الخاصة بالمستندو ,مص‎ 
:معالج حدث "'بدء‎ Print ocument من تم ينتقل الإجراء إلى أحداث نسخة " ٤٣مصںءهطامنم".كما ترى فقد قمت بمعالجة أثنين من أحداث‎ 
الطباعة "نومع " والذي ينجز بعض العمليات التمهيدية للطباعة»ومعالج حدث "اطبع صفحة موه منم " والذي يقوم بالعمل الحقيقي .(يوجد‎ 
" QueryPageSettings أحداث أخرى مثل "آنهي ائ¦طبlعؤEndPrint "»والذي يستخدم للتنظيف عند اكتمال الطباعة»و"استعلام إعدادات انصذخّة‎ 
زا كاك انامه تعر الةو إغ#اداك ك فة من السكف رعلا ها لس الل الس رخاضة إن كنت عى كر اة‎ 
ا ی کا اکن کو کے اک مو ال ا ع م لا عر ا کم ا اا ر هتت ن اة‎ 
تراق‎ 
يبين الشكل التالي الصفحة2 من المخرجات الناتجة عن هذا البرنامج .تستطيع أن ترى في الزاوية اليسارية الدنيا أنها تسجل بشكل كامل‎ 
کاک کف د اا‎ 


اة "حوار معاينة الطباعة وم اها سهاره٣‏ ٥۲٠نم‏ ".حالما تعمل على إضافة ووضع الأدوات السابقة في مكانها »أضف معالج حدث نقر الزر الثاني 
التالي: 

Era ee CUS BUEEONZ CUTENESS SERIE AS VSM OCONEE CUN CE LS VEER EUEMEAEIS) MORILES 

EU OR CITE 


End SUG 
El Print prevîe E 


2 - DH O B&B mH mM Close Page| 2% 


2 


کما تری هذا الکود بسيط جدا. 


خلال عملية الطباعة(أو المعاينة)ءيتم استدعاء معالج حدث "أطبع صفحة موه ہزم " لأداة ts‏ 0cumenطintمPمرة‏ لكل صفحة مخرجات. ولكن 
يوجد شيء يتطلب براعة:فعندما تم استدعاءِ معالج الحدث "أطبع صفحة موھ ہزم " للمرة الأولى لم يكن لطباعة "أول صفحة" من 
المستند»ولكن لطباعة "الصفحة الأولى في حاجة الطباعة"» ومهما يكن رقم الصفحة.ابحث في جميع خاصيات قارو أداة)"طباعة مستند 
inth0cumentمP"»‏ ولکن لن تجد ابداً خاصية"عدد الصفحة مطصں وهم ٠"‏ ففئة "طباعة مستند Prin tDocument‏ " لا تعلم أي شيءَ حول عدد 
الصفحات في مستندك»و على الرغم من كل شيء فهذا لایهم. کل ما تعلمه أن هناك حزمة من الصفحات بحاجة طباعة»وستعمل على استدعاء 
معالج حدث "أ أطبع صفحة موھ ٥1ہام‏ " حتی تقول "کافياوںoہم‏ ". 

اذا رجعت لئ الشكل الثالث»سترى أن حوار الطباعة e‏ مقطع" مجال الصفڪحlتRange Page‏ 1 على الرغم من أن ج أدواته غير 
فعالة بشكل افتراضي .فان أداة "حوار الطباعة PrintDialog‏ ' "' تتضمن ثلاث خاصیات منطقية 2ا00 8والتي تتیح لك تمکین أدوات خاصة في 
ذلك المقطع للصفحة الحالية موھ Curren ٣P‏ owااA‏ "٠"السماح‏ لبعض lلصفaتAllowSomePages‏ "»و"السماح لما تم اختياره 
AllowSelection‏ ". فوضع أي من هذه الخاصيات إلى صح eھں٣۲یمکن‏ خیار الأداة الموافقة.فيما بعد وبعد أر ن يختار المستخدم»بإمكانك الاستعلام 
عن خاصیة " ange‏ interSettings.Prin1RمP‏ " لکائن"طباعة مستند P۲90 cume‏ " اتحدید أي خيار هو. 

اقل على إضاف كرد يكن اخقار محال الصقداك رمق لي محر فة الاك اسه قا اقات ال هة فر ك 
بإمكان المستخدم أن يكون قادر على اختيار مجال فرعي ضمن المجموعة.ارجع إلى معالج حدت النقر للزر الأول»ءوأدخل عدة أسطر من الكود 
وهي بالخط الغامق: 


Mhm76 الفصل عشرون:الطباعة.‎ 
Erie ee SUS BUEEONL CMTE EVV SERIE AS SMSEEME ON CSE CElel E ES SVSECMSEVEREAEEIS ) HONGO ES 
BUEEORL CER 


End SUS 
فعندما ينقر المستخدم على زر "طباعة" وهو نفس الزر الأول والذي سميته طباعة أما الزر الثاني فقد سميته معاينة »فسترى أن مقطع مجال‎ 
الصفحات لصندوق الحوار قد مكن حقل الصفحاتءوفيه العدد الأكبر والأقل من الصفحات في المجال "1 - 5"(شاهد الشكل التالي).‎ 


* Print F\K 
laeneral 
Select Printer 
إضانة طابعة [ف]‎ 2 Perfect POF Creator 
î hp Lasernlet 1010 3ı Send Ta OneNote 2007 


da Microsoft #PS Document writer 


Sal: جاهڑز‎ Print to file 
Location: 
Cornmeant: 
Page Range 
OA Number of copies: | 1 3 
Selection Current Fagğe 

@ Pages: Collate e 

اہ آ2 2 1 1 


Enter either a single page number or a single 
page range. For example, 5-1 


[ ]|[ داق ]| طيف_] 
إذا ضبط المستخدم هذا الحقل إلى"6-1"سيحدث خطأ يخبر أن المجال هو ضمن "5-1"فقط.ولكن إذا اختار المستخدم جميع الصفحات أو 5-1 
أو 4-1 أو 3-2 أو الصفحة الحالية أو أي اختيارءفإن معالج حدث"أطبع صفحة موه ٥۲٣1م‏ "سيتم استدعاءه بنفس الطريقة. في الحقيقةءسيتم 
استدعاءِ المعالج کثیراً»وحتی المئات من المرات»حتى تخبره بأن يتو قف.يوؤٽثر اختیار المستخدم في خاصية PrinterSettings.PrintRange‏ وبعض 
الخاصيات الأخرىءولكن لايؤثر مباشرةٌ في عملية الطباعة. إن تغيير سلوك عملية الطباعة المعتمد على هذه الإعدادات راجع إليك.لنتظاهر أن 
المستخدم أدخل مجال طباعة من 3-2.فلا نستطيع أن نسمح لأداة "طباعة مستند ٥ ٥ں ٥٣٤‏ اہم " من إطلاق حدث"أطبع صفحة موه ۲زم "من 
أجل كل الصفحات الخمسةءلأنه حتى ولو أنتجنا مخرجات لكل من الصفحة2 و3ءسنبقى نحصل على ثلاث صفحات أخرى فارغة تخرج من 
الطابعة.مانريده هو أن يكون لدينا حدث يتم إطلاقه مرتان فقط.مرة من أجل الصفحة2 ومرة أخرى من أجل الصفحة3.فنحن بحاجة إلى تعديل أو 
ضبط استخدام المتغير موه ۴ ۸ء ام۷ الخاص بالتقاط محتوى الفئة ليكافئ المجال الموافق.أولاءلنغير معالج حدث"بدء الطباعةاہ مومع "ليستخدم 
رقم صفحة البدء الصحيح. 


Private Sub CountingDoc_ BeginPrint (ByVal sender As Object, _ 
BYual € RS SVS ECEM. DESIG SEED ENI E EADIE EVEN EAESSD 
Handles PrintDocument1.BeginPrint 

Start the counting over.‏ ا 


e 
في معالج حدث"أطبع صفح موھ ۲مم "يجب علینا تعديل الكود الذي يحدد متى تتم مغادرة عملية الطباعة.‎ 


بما أن كود المعاينة يتشارك إعدادات نفس المستندءنحتاج لتعديل كود المعاينة لنجبره على طباعة جميع الصفحات دائما: 
Era e CGS BMEEON2 CUTE ENB Seer AES EMSEEME ONCE BON CE ES ECVESECREEVEREAT ISD) HONA NES‏ 
BU EOn2 Cle‏ 
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ENA SUS 


إذا شغلت البرنامج وضبطت مجال الطباعة»يجب أن تحصل على الصفحات التي تطلبها فقط. 


إن استخدام +ا60لتوليد صفحات طباعة بسيط جداً.أما من أجل الصفحات المعقدة»من المحتمل أن يكون عليك عمل الكثير من التموضع 
رالقاسات لمال التضرضن والثر ضيف أ ار تقار كن خلاص القرل ارش ها اقفن ار فة الكل عد ها الموضم للف تدع كل 
الطابعات التطبيق الذي يطبع بواسطة ا65 وطريقة الطبعة امام .وهذا بشكل خاص صحيح للطابعات المستخدمة لطباعة كروت التسليف 
الحراريةهءجء أله اج٣۲٠ط]‏ . على الرغم من أن بعض هذه الطابعات يمكن أن يكون لها مشغلات على الويندوز»فهي في الحقيقة مصممة 
لتكون على اتصال مباشر مع تطبيق ما بواسطة لغة " الترشيح أو الفلتر المتسلسل مء eںوهء‏ ممةعءه " من أجل مثل هذه الطابعات»ءتحتاج إلى 
الكتابة بشكل مباشر إلى الطابعة في نمط"المباشر أو الصرف سهم " (ما تكتبه من تطبيق خاص تطبعه دون أي معالجة للنص)ءحيث أنك تتحكم 
تماما بالحروف التي يتم إرسالها إلى الطابعة.(عملياء ليس عليك الدخول مباشرة إلى الطابعةءفما يزال بإمكانك الكتابة لطابور(صف)الطابعة 
ueueو‏ printe's»وتدع‏ ويندوز من إدارة جدولة عمل الطباعة) 

إنه لمن المؤسف أن أخبرك أن الدوت نت ينقصه دعم متل هذه الطابعات(الطابعات الصرفة أو المباشرة)على الرغم من أن مكتبة الربط 
الديناميكي 1ا ا2يتم تضمينها بنوافذ تمكن طريقة الطباعة المباشرة هذه»ءفإن دتثار دوت نت المدار ممم هاس ..٤۲‏ dموممهص‏ لهذه المكتبة لايتم 
شحنه مع إطار العمل framework)‏ . 

حسناءإن الأمر ليس بهذا السوءءفقد عملت ميكروسوفت وبعض المبرمجين على نشر كود يربط استدعاء مكتبة الربط الديناميكية الغير مدارة 
unmanaged DLL cas‏ إلى المکافی المدار وہ eاe»uiva‏ e۹dوan2ص‏ .سنستخدم تنوع لبعض من هذا الكود في مشرو ع المكتبة راطا مما 
ئءهزهP‏ في هذا الفصل لدعم طباعة قطع بطاقات صندوق الدفعءمناء )همع ءأوراق الوصول(فاتورة أو وصلءام‌اهءه] ۲همهم )والتي 
تمنح الزبون أو المشتري ١٠]هممعرفة‏ بالبنود المقيدة للدفع ااه ١ه)ءهطء‏ ومتى سيتوجب الدفع )وط مuل‏ . 


كمقدمةءيركز مشروع هذا الفصل على طباعة الشيكات اںم)ءهمموفواتير الدفعءام‌امءهء أامصرهمهماf‏ »ءولكن سنضيف أيضا كل الكود الذي 
یسمح للمشترین 5١٥ھ‏ موآمناء المکتبات ۸ھ طا من تسجیل مدخلات ومخرجات الکتب )مط check in and cheek out‏ وبنود المکتبة 
الاخرى. 


إن الكود الأصلي لهذا التطبيق قد أتى من علوم ميكروسوفت المقال الأصلي رقم 322090ءوالذي يشرح دعم الطباعة المباشرة من تطبيقات 
الدوت نت .فهو یستخدم ميزة الدوت نت المعروفة ف interop‏ والتي تتیح لکود دوت نت من "llتفlعinteroperateJ‏ 1 مع المكونات غير 
المدارة المعتمدة على الكم C00۷‏ والتطبيقات اJأفدم .older unmanaged COM-based components and applications‏ 

أنشئ فئة جديدة وسمها"ط۲.۷٠مام R۴٣۲‏ "واستخدم الكود التالي لتعريفها: 


Imports System. Runtime. InteropServices 
Public Class RawPrinterHelper 
622090 اكوك قف مته الت ممه على معلومات مبكروسوفت وضورع لالا عدي رع‎ ! 
Web: http://support.microsoft.com/2i1d=322090 
"2٥1 وتصريجات تركيب‎ 
<StructLayout (LayoutKind. Sequential, CharSet:=CharSet. Unicode) > Private Structure DOCINFOW 
<MarshalAs (UnmanagedType.LPWStr) > Public pDocName As String 
<MarshalAs (UnmanagedType.LPWStr) > Public pOutputFile As String 
<MarshalAs (UnmanagedType.LPWStr) > Public pDataType As String 
End SErFUGEUEe 
SDIITmMPOrEE (UwInRSpPOOlL .DEvl, ENEFEVEOINE: - "OPENEIInlLerNL, SeCLaSLEETOE:-TEUe, 
CMarcel i EMarESe E URTE OMe, | 
Exale e pel ARE SNE UE, CALICO VERE LOR HE aA IRE EOReR EON EAC ES 
Private Shared Function OpenPrinter (ByVal src As String, ByRef hPrinter As IntPtr, ByVal pd As 
Tong) As Boolean 
End HUNG ELON 
SDI UIMOOSE E INITNSDOON DEVIL, ENEFVEOINE SZ CIOSGEFIDNECEL, SEELOSEEECEO: TFG, 
CME SEE f CME OEE ULES, _| 
Exact S pel mo IE ue, Call inoConvenEi1 OR Calli nEE Onen E1 OR SESE IL) | 
Private Shared Function ClosePrinter (ByVal hPrinter As IntPtr) As Boolean 
End EuUnREEC LOM 
SDI VN IMOOE EINES DOO DEVEL, ENEFVEOINE < SEAEEDOCETINECOFUNL, SEEVESEBEEOE FUE, 
CME BEE f SCE EEE UAC, |_| 
Eza kS pel imo IE uey, Calling ConvenEi On Calling EC OnvVeR Elon SESE) 
Private Shared Function StartDocPrinter (ByVal hPrinter As IntPtr, ByVal level As Int32, ByRef 
pDI As DOCINFOW) As Boolean 
ERG FUnECELON 
SDITLImMpOr E (IwinSpPOOl ‘Dev, ENErYVEOINE: = "ENODOCErIREerl, SEeLLaSLELEOE:=TrEUE, 
CRIES E SERA SE E URI COE, 
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HS UE 
EURGCE OM yVal As AE 


ByVal 5 ByVal 


ce 
> 


AS SEFING 


Then 


إن الكود نسبيا واضح المعالم اںم-٣‏ جما »حيث أن الطريقة 0P6‏ وم 0S)‏ هءتحضر نص ما للطباعة بتحويله عنوة إلى هيئة أنسي القياسي 
ا8 dard‏ stan.ومن‏ ثم يستخدم الوظائف(الدوال) في مكتبة ۷ه ./مممءم/س لفتح عمل طباعة جديد»ويرسل المحتوى المحضر إليها. على 
العموم يوجد الكثير من الترتيب(الترتيب المتصاعدوم!ااهء۲ه ) المستمر في الكود من خلال أعضاء فة ووواع ا٣ء‏ .حيث أن مكتبة 
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آل ر شا Mhm76‏ 
wisp. rv‏ غير مدارة.جميع البيانات يجب أن تنقل جيئة وذهابا بشكل غير مباشر بين تطبيق المكتبة المدار ة ومكتبة .امموس الغير 
مدارة 

رة . 


فئة مساعدة من أجل طباعة تذكرة خاصة بزبون ما.أنشئ فئة جديدة yوÎaw CheckedOutltem.vb‏ وبدل محتواها الفارغ بالکود التالي: 
Public Class CheckedOutItem‏ 
N TC BRE Ga‏ 
على الرغم من أنها تدعم طباعة وصول الاستلام 
Public ItemTitle As String‏ 
Public CopyNumber As Integer‏ 
Public Barcode As String‏ 


سنستخدم هذه الفئة لنقل التفاصيل لأن يتم طباعتها على الفاتورة(التذكرة) عندما يتم تفحص بنود المخرجات.فيما يخص طباعة التذاكر »لنعمل 
على إضافة الفئة التي تقوم بعملية الطباعة الحقيقية. قم بإنشاء ملف وحدة برمجية جديد ماهم" (و لیس فئة) و سمه طہ .ونا٣ 7۸۵1۴٣‏ وأضف 
له کود الذي يملا الوحدة البرمجية : 

Module TicketPrinting 


End Module 
استدعاء هذه‎ püy.PrintPaymentTicket y PrintBalanceTicket gs PrintCheckoutTicket يحتوي الكود على ثلاث طرق تقود عملية الطباعة:‎ 
الطرق من أجزاء آخرى ضمن التطبيق عندما يحين وقت تقديم كرت مطبوع للمستخدم.تتضمن الوحدة البرمجية أيضا العديد من الطرق الأخرى‎ 
والتي تدعم هذه الطرق الرئيسية الثلاث.وحيث أن هذه الطرق الثلاث نوعا ما متشابهة في التركيب»ءلذلك لنلقي نظرة على الدالة‎ 
.PrintCheckout Ticket 


Public Sub PrintCheckoutTicket (ByVal patronID As Integer, _ 
Val checkedOutItems As ListBox) 


۳ 


الفصل عشرون:الطباعة. Mhm76‏ 


Ene saaeror (rieketPEIREIRGerIftEheGKOURIEKeE™ sr esteesptie 0) 


End Sub 
يبني الكود متغير نصي ما(فعليا هو باني النص۲٠ه اا8 و 5)1 ) لعرض المحتوى»إضافة تفاصيل حول كل بند اختبار مخرج لمجزئ النصوص‎ 
( receipt prit لإرسال المحتوى لطابعة التذاكر (الفو اتير‎ send String 0P rite ومن ثم يقوم باستدعاء‎ .string buffer 
بإضافة الكود الذي يستدعي )ءاه )همام فيما بعدءأما الآن لنضيف الكود الذي يستدعي‎ موقنس.)My.Settinوs.Recمأم‎ 1P ہ٣ المر كبة(‎ 
الطريقتين الأخريين .عندما يغلق نموذج سجل المدفو عات ٣ه ١0۲ء٠۸ ٣٠.ره۴ ءنريد أن نطبع تذكرة لجميع المدفوعات المعمولة بشكل آلي‎ 
»تماما قبل الكود الموجود حاليا في‎ Patron Record.Ac1٤|0sم_ في الوقت الذي يتم فيه فتح النموذج.قم بإضافة الكود التالي إلى معالج حدث »عا‎ 
المعالج.‎ 
Erivate SUD ACEC LOSE CCK (BYU Sender AS SvSilEeM I OONEGE, EVUSN € AS OS EOM EVEN EAEIS) Hendi lles 
ACECIOSEe . CITI CK 
طاعة بطاقة عند الحاحة‎ 1 
E (Sesi OnEa vmMen ESE COUnNE > O) Then J 
PrintPaymentTicket (ActivePatronlID, SessionPayments) 


SessionPayments. Clear () 
SessionPayments = Nothing 
إغلاق الفورم‎ 1 
Me.DialogResult = Windows.Forms.DialogResult.Cancel 
End SUS 


يطبع مشروع المكتبة ثلاث أنواع من أكواد التعريف:(1)بند أكواد التعريف التي يمكنك أن تلصقها على الكتب»السيديات»وآي شيء أخر يمكن أن 
یتم اخراجه أو یتم ادارته بواسطة النظام»(2):أكواد تعریف المشتري والدي یمکن عمله ضمن كروت المشتريين المتطابقة(3):أكواد تعریف 
متنوعة(الأخرى) والتي يمكن للمكتبة ن تستخدمه لأي هدف أخر.كل من هذه أكواد التعريف الثلاث يتم طباعتها من خلال النموذج 
BarcodePrint‏ .یيبین الشكل التالي الأدوات المحتواة ضمن هذه الفورم. 
لقد عملت مسبقا على إضافة هذه الفورم إلى المشروعءمع كودهاءإليك الكود الخاص بزر المعاينةءوالذي سيبدو معروفا بعد أن أقدمه لك من 
خلال هذا الفصل. 
Eri vate SUD AECL CIEE (BYU Sender AS SVSEOM OONESE, EVIN E AS SYS EOM EVEN EAEIS) Hones‏ 
ACE EEE CME‏ 
EEA EE LS EET EE‏ 
Dim whichTarget As Integer‏ 
On Error Resume Next‏ 
a 1‏ ان اا و ور اکت کک 


If (VerifyFields () = False) Then Return 
جل عه اتال احادة هة لن نه اس اناق الط اة‎ 1 
If (LoadPageDetails() = False) Then Return 


1 اسو الال فل عة ااا ات ومن د ال ااه 
Me.Cursor = Windows.Forms.Cursors.WaitCursor‏ 
PageSoFar = 0‏ 
PreviewMode = False‏ 
BarcodeDoc = New System. Drawing. Printing.PrintDocument‏ 
BarcodePrintDialog.Document = BarcodeDoc‏ 
Tf (BarcodePrintDialog.ShowDialog () <> Windows.Forms.DialogResult. OK) Then‏ 
BarcodeDoc = Nothing‏ 
Me.Cursor = Windows.Forms.Cursors. Default‏ 
REEUEN‏ 
ا 
BarFCOoOdeDOE ELIE)‏ 
BarcodeDoc = Nothing‏ 
Me CUESOE — WINIOWS. EOEMS.CUESOLS . De faul E‏ 
1 سوال الخدم حول فاح الصا 
TE (MSGEO E E E Ea CES, MSGEOSSEYle. HeSNO OE MSGEOXS ELE OES 1 OR,‏ 
rO rei EUS) = |‏ 
MsgBoxResult.No) Then Return‏ 
E‏ ا کے ا ا 
whichTarget = Clnt (CType (RecordType. SelectedItem, ListItemData) )‏ 
Tf (whichTarget = BarcodeOoutput. Item) Then‏ 
ES LEE 1‏ 
SetSystemValue ("NextBarcodeItem", CStr (Val (RecordStop.Text) + 1))‏ 
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الفصل عشرون:الطباعة. 


کود زر کک مشابه لهذا الكود تقريباًءولكنه نخدم حالة PrintPreviewDialog J3 PrintDialog‏ .ويتعقب أيضا رقم كود التعريف النهائيء 

بالتالي يمكن ا ن یساعد على تجنب تداخل طباعتها في المرة القادمة. 

يعمل معالج الحدث موه1۴ا”ا۴_٥0 84٠١۵٠0‏ طباعة كود التعريف الحقيقي.يعمل كوده على دمج معالجي حدث 

BarcodePage.PreviewArea_Paint sy BarcodeLabel.PreviewArea_Paint‏ إلى جهاز طباعة رائع واحد.لتمکین استخدام نموذج طباعة كود 

التعريف»أضف العبارات التالية إلى معالج الحدث »ءاe_C‏ ل20 tReporis8ءوفي‏ فئة الفورم الرئيسية ٣۴0۲۳‏ أة". 
ByVal As Object, ByVal e As Handles‏ 


من أجل زبون المكتبةءالشيء الوحيد الأكثر أهمية من البنود المخرجة والمدخلة هو القدرة على قراءة تلك البنود.لن يساعد مشروع المكتبة أيا 
كان بذلك»ولكنه سيعمل أشياء مداولة الإخراجءالإدخال على طول الكود الذي نضيفه في هذا الفصل.لنعمل على إضافة كود التجديد من أجل 
البنود المخرجة حالياً.الزر "تجديد سهم هR‏ " على نموذج سجل الزبون لإهعهR‏ ۸٠ء]ه‏ يبدأ هذه العملية.أضف الكود إلى معالج حدث النقر 
PatronRecord.ActRenewltemsOut_Clickو‏ الذي يعمل التجديد. 


الفصل عشرون:الطباعة. Mhm76‏ 


Mhm76 الفصل عشرون:الطباعة.‎ 
TEAanNS aC E LORE OMNI E0) 
تحديث العرض‎ 
1temDetail.DueDate = dueDate 
ItemsOut.Invalidate (ItemsOut.GetItemRectangle (ItemsOut.SelectedIndex) ) 
Me.Cursor = Windows.Forms.Cursors. Default 
Return 
ErrorHandler: 
Me.Cursor = Windows.Forms.Cursors. Default 
CER OE MEE OE (EA Er ONGC OE ICL S ERE REW ESMSO E CINE ET BE CEEENGEED ESRD 
On Error Resume Next 
1E Noe (OoInNEO LS NoEhInGD Ten GOINEO. CLOSER) E OBINEO - NOERNING 
TransactionRollback () 
Return 
el SUS 
يعمل الكود بعض الحسابات لتحديد تاريخ استحقاق الإعادة الجديد(متجنبا العطل) ومن تم تحديث قاعدة البيانات في المداولة.‎ 


TransactionBegin () 


إذا أضافت مكتبة لصاقات كود التعريف لجميع بنودهاءفسيكون الإدخال والإخراج بواسطة قارئ كود التعريف.ولكن بالنسبة لمكتبة صغيرة 
تستخدم البرنامج يمكن أن لا يحتاج الكادر دعم الإخراج والإدخال بالعنوان.خلال الإخراج أو الإدخالءإما يدخل المستخدم كود التعريف أو 
العنوان(جزئي أو كامل). و من المفترض أن لا تكون المدخلات العددية عناوينءولبدء البحث بالعنوان.الفورم ط۷.مں )هه ا)ء ممع الجديدءالمبين 
في الشكل التالي يعرض جميع التطابقات من أجل عنوان تم إدخاله. 

الإخراج بالعنوان 


العنوا 


ن النسخةاكود اريف 
الصؤلف الاسم نوع الوسيطة 


على الرغم من أن الحقول على الفورم بشكل أولي مطابقة لما تم إخراجه فقطءتقوم الفورم بمهام مضاعفةءتحويل مظهرها من أجل أهداف 
الإفخال. بالإضافة إلى جدراة المدخلات مضودة إلى لك الننوذ المقطابقة والئى ت إخراجها سايق 

غبلت على إضاقا هذه اتروع مقرو عك هع الكرد المضدرى قل حف كرد عن قاع الات من آل افنرة الما ويرك الكت 
باستخدام حامل رسم صندوق القائمة×0طاءاا سوال هسه .وهو مجموعة جزئية من الكود الموجود في الفورمطv.مup)م‏ ما ")| .الاختلاف 
الحقيقي الوحيد بين المدخلات والمخرجات يحدث في الطريقة مں)ه ها ۲ه۴٣٠ع.يبدأ‏ مقطع الكود هذا ببناء أمر سكول الاختيار بند رئيسي»ومن ثم 


إنهائه بهذه العبارة. 
u Kl asehecln) Ren Sol Rex Ga AD AC TUS‏ 
Else sqlText &= " AND IC.ID NOT IN"‏ 
sqlText &= " (SELECT ItemCopy FROM PatronCopy WHERE Returned = 0)"‏ 


لذلك فالاختلاف في " | "مقابل " NOT IN‏ ". 


الدالة |٠‏ ر8صهtا)ءممهي‏ الواجهة الرئيسية لمنطق الفورم. 
Public Function CheckItemByTitle (ByVal CheckIn As Boolean, ByVal searchText As String) As Integer‏ 


تمرر لهذه الدالة العنوان المزود من قبل المستخدم(۲»×٠٣۸ءههء)وعلامة‏ تشير إلى حالة الإدخال أو الإخراج»وتعود بحقل قاعدة البيانات هط 
ltemCopy.ID‏ من أجل بند المكتبة المختار. 

جميع التغيرات في هذا الفصل تحدث في فئة الفورم الرئيسية ٠,‏ ۴ہج" «لذلك دعنا نذهب إليها.تضبط الطريقة ولاه ۴رمامءاطمtو۵ملميزات‏ 
الفورم الرئيسية عندما يدخل المدير أو يخرج.واحدة من الميزات التي لم نأخذها بالحسبان من قبل» وهي إمكانية المدراء تعريف إخراجات بنود 
من تحديدهم دون مساعدة أمناء المكتبة.لدعم هذه الميزةءنحتاج إلى تغيير بعض الكود في ائ¦طريقUpdateDisplayForUserÃ‏ . بدل الأسطر التالية 


من الكود: 
LabelTasks.Visible = False‏ 
LineTasks.Visible = False‏ 
PicCheckOut.Visible = False‏ 
ActCheckOut.Visible = False‏ 
بالأسطر التالية ٠‏ 
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الفصل عشرون:الطباعة. Mhm76‏ 

ES E ET EN GEST IEE O EES 

Dam uSezCané Rec KOUE ES Boolean > J 

CBool (Val (GetSystemValue ("PatronCheckOut™) ) ) 

LabelTasks.Visible = userCanCheckOut 

LineTasks.Visible = userCanCheckOut 

PicCheckOut.Visible = userCanCheckOut 

ActCheckOut.Visible = userCanCheckOut 


ونحتاج أيضا إلى إضافة كود أمن مناسب مشابه للطريقة اه )ءم م٥‏ »ءه٣.إليك‏ الأسطر الأولى من الكود من تلك الطريقة . 


E‏ االع رض 
Al1PanelsInvisible ()‏ 
E SSE UE EEE OE HO EEE dE VOCE GUE HEV EACRE E E OME TEENS) EREN E‏ 
PanelCheckOut.Visible = True‏ 
بدله بالكود التالي: 
EM O E‏ 
Dim userCanCheckOut As Boolean‏ 
E‏ 5 > اكان ال ان الحرل دة ام 
userCanCheckOut = CBool (Val (GetSystemValue ("PatronCheckOut™") ) )‏ 
1 ا العرض 
Al1lPanelsInvisible ()‏ 
TE (USeECanNEC hec EOUE OE j‏ 
SSE EN EYE EOE le (E SE dE VOSS GUE HEVE CRE E E OME TEENS) ERE‏ 
PanelCheckOut.Visible = True‏ 
المخزنة في MainForm.StatuslmagesölsÎY'‏ .سیتم استخدام هذه الثوابت فی بعضص الكود ذو الصلة بالإدخال المضاف فیما بعد أضف الكود التالى 
إلى تعريف الفئة. 
Private ActiveCheckOutPatron As Integer = -1‏ 
Private Const StatusImageBad As Integer =‏ 
Private Const StatusImageGood As Integer =‏ 


عندما يحدد المستخدم الزبون للاستخدام من أجل الإإخراج»ومن ثم يبدا الإدخال إخراج البنود»ستكون الخطوة الرئيسية هي النقر على الزر 
إنهاء»مشير! إلى نهاية عملية الإخراج من أجل زبون.(شاهد الشكل التالي إذا e‏ 'انھاء ا لآن) مهما بن :لایو جد ٿيءَ يعمل علئ 
إيقاف المستخدم من القفز إلى جز ء آخر من البرنامج»أو من او من البرنامج بالكامل»بدون نقر الزر "إنهاء" .يدون النقر أولك علئ الزر 
"إتهاء " أولاءيجب أن نستبق هذا السلوك الغير مرغوب بحيث يتوافق مع برمجيات المستخدمين.لضمان إتمام الإخراج بشكل متاسب»ستعمل 
لن إافة يعض اكزد إلى تفت آماكن في القررع ار نة والذى سمل عى إفقتاصن آي فمل قير م رغرب من فل الستم اشفة الكره 
التالي إلى بداية الطرق الثلاث التالية:(1) معالج الحدث وہosiاC n۴ ٥۲ص ةقيرطلا)2(ءMainForn_۴ ٥r‏ iوoاsh0w»ءو‏ (3) الطريقة 
.AllPanelslInvisible‏ 


EET EE WEN BELE OL 
lÊ (ZetivechecKOuEEaEron <> 1) Then AcCtEInI SHChEeCKOUE .BeLEOLMCLICK (0) 


يظهر جمیع کود الإخراج في فئة الفورم الرئيسية(ما عدا الكود في الفورم طر (CheckLookup.‏ .الإخراجات واحدة من تمانية لوحات عرض 
رئيسية يمكن الوصول لها من خلال هذه الفورم.(شاهد الشكل التالي). إليك المعالجة من أجل البنود المخرجة من لوحة "البنود المعارة"": 
1.ينقر المستخدم زر"زبون" ويحدد الزبون الذي سيخرج البنود. 

2.يعمل المستخدم على إدخال العنوان أو كود التعريف من أجل كل بند من أجل إخراجه»ءوينقر الزر "إخراج" من أجل كل واحد. 

3 ينقر المستخدم الزر"إنهاء" عند يكتمل الإخراج. 


ة بنودرحدد اول الزبون باستخدام زد الزيون. ...ومن تر أدخل كود التحيف أو 
آ ا ل ا ی حقل إدخال النص .قي الأسفل .عند الالتهاء راز 
الذد "انتهى "ء 


كود التجريف أو عنوان بند(مح خياد القيم الشاملة الاختياية) 


إخراج | 


البنود المعارة 


,items checked out 0 @ 
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الفصل عشرون:الطباعة. Mhm76‏ 
لنعمل على إضافة الكود من أجل كل من هذه الأزرار الثلاث. أو لاء« أضف الكود من أجJ .ActCheckOutPatron_Click lla‏ 
يطلب هذا لكود من المستخدم من أجل اختيار الزبون»ويعرض الحقول المتبقية في حال النجاح.إليك جزء الكود الذي يعرض سوال المستخدم: 


أضف كود إلى معالج الحدثمءزاC_؛0‏ )٥٠٣٤هام‏ »والذي يعالج كل بند من خلال الزر"إخراج". 
كما ذكرت من قبل»ءيفرق هذا الكود بين المدخلة العددية(أكواد التعريف) والمدخلات الأخرى(العناوين). 


أخيرآًءبعد التحقق من أن البند متاح للاستخدام»يعمل الكود على إخراج البند بتحديث سجلات قاعدة البيانات ذات العلاقة. 


الزر الثالث والأخير هو الزر"إنهاء".أضف الكود إلى معالج انحدث .ActFinishCheckOut_Click‏ 

يعمل هذا الكود على إعادة تنضيد حقول العرض في التحضير إلى الإخراج التالي للزبون. 

صندوق القائمة ×هطاءiاعلى‏ لوحة"البنود المعارة" يحتاج إلى عرض عمودين من البيانات:(1)تاريخ الإعادة»و(2)تفاصيل البندءمثل العنوان 
وكود التعريف. هذه القيم تم إضافتها إلى القائمة باستخدام الفئة ٣٠اااںت‏ 0ه )ءههع التي أضفناها سابقاً في هذا الفصل. أضف الكود إلى معالج حدث 
.CheckedOutltems_Drawltem‏ 


البنود المدخلة أسهل بكثير بما أننا لا نحتاج إلى تحديد الزبون أول. كود التعريف أو عنوان البند المدخل كافي لإتمام جميع العمليات. يبين الشكل 
التالي لوحة "البنود المستعادة". 
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الفصل عشرون:الطباعة. Mhm76‏ 
جه مشروع المكتبة 7ا 


Administrator :3رlد|‎ pain 


E E‏ الأسغل رعند إدخاد 
عنوانا رتستطيع تضمين حرف القيمة الشاملة"*".انقر الزر إدخال لمعالجة البند. 


تاريخ الإعادة أو الإدخال؛ ا 


Wednesday, February 
اليوم‎ 


كود التحريف العنوان: 


La] 


a 

اسب یه 

امه سی 
تلن س الا مزر اتاریخ دما سيتم إعادة البند,عادة هو اليوم الحاليولكن إذا تم إعادة بنود المكتبة إلى مخزن المكقية خلال آلليل بعذ 
ساعات العملءمن المحتمل أن أمين المكتبة يريد ضبط التاريخ إلى "البارحة"ءفقط في حال ٤‏ إعادة هذه البنود قبل منتصف الليل.دعنا نضيف 


بعض الكود بحيث تشير اللوحة ال "اليوم 1 أو "البارحة' "أو لی يوم أخر عند تغيير التاريخ أضف الكود التالي ال معالج الحدث 
.CheckedInDate_ValueChanged‏ 


الإدخال الفعلي يحدث عندما يعمل المستخدم على إدخال الباركود(كود التعريف) في حقل النص»وينقر على زر "إدخال".أضف معالج حدث 
actDhoCheckın_Clickللفورم‏ الرئیسیة. 
Handles‏ 


بعد عمل بعض البحث وتأكيد المراجعةءيعمل الكود على إدخال البند من خلال تحديث قاعدة البيانات. 


هذا كل شيء الآن»ما تبقى إضافة الكود الذي يعالج بشكل مناسب غرامات البنود قبل إدخالهاءوسنعمل ذلك في الفصل 22 
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Mhm76 
الفصل عشرون:الطباعة.‎ 
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الفصل الحادي والعشرون:التقارير. Mhm76‏ 


lلتقارjı Reporting‏ 
من أجل مطوري تطبيقات العمل التقارير هي حقيقة الحياة.من المحتمل أنك تمضي وقتك في تطوير واجهات المستخدم أو استكشاف وفهم الخوارزميات المستخدمة بشكل عام في 
مبادئ احتساب البيانات المقيولة.ولكن بالمقابل.تستثمر العديد من الساعات المملة كل أسبوع في إنتاج تقرير بعد تقرير.وتشكل هذه التقارير رسوم مهمة على طائفة البرمجة. في 
أمريكا لوحدهاء تقدر مراكز التحكم والوقاية من الأمراض حوالي 850تقرير متعلق بالأموات سنوياً-وهذا لا يتضمن حتى إحصاء الذين قرؤوا تلك التقارير. لذلك إذا كنت مبرمج 
عمليءفإن التقارير داخل مستقبلك.تتضمن الفيجوال أستوديو و الدوت نت العديد من الميزات المتمركزة حول التقرير وأدوات يمكنك استخدامها تماماً بلا حدود. 
يناقش هذا الفصل بعضاً من موارد هذه التقاريرويحاول بجهد العثور على معلومات أعمق حول أدوات التقرير المستخدمة في مشروع المكنبة. 


يتضمن التقرير عرض وطباعة بيانات أساسية ومختصرة للمستخدم من أجل أهداف عملية معينة.تتضمن الفيجوال بيسك2008بطبعتها الاحترافية ست طرق رئيسية لاإتمام هذا 
الف عض الطعات الأكرك تضرف إلى أ ل من فمحذة الخيار ات فذة,وتإمكاك حالما تخسن فة القانمة باستخداء أات مشاركة تانوة 


كما تعلمنا في الفصل السابقءيتضمن إطار عمل الدوت نت نظام طباعة معتمد على كائن ١#ءةطاءهزطه‏ يستخدم أوامر +ا60لرسم نص ورسوميات ءءإمة۲وعلى كل 
صفحة طباعة.بما أنك تستطيع وضع أي شيء تريده على كل صفحة.فتستطبع تطوير تقاريرك الخاصة باستخدام هذه الطريقة.إن مسؤولية وضع كل لافتة وحقول محسوية على 
الصفحةءوتحديد متى سيتم التنقل إلى صفحة جديدة.كل هذا بالكامل سيكون على عاتقك.ما تزال أوامر ال+ا620 بسيطة.ءوتطوير بعض التقارير القاعدية باستخدام هذه الطريقة لن 
يكون محبباً.إذا كنت تريد أخذ هذا المسلك من أجل تقاريرك. أفضل عودتك إلى الفصل20 وميادئ الطباعة الأساسية الموجودة هناك. 


إن الانترنت(ولغة وصف الصفحات المعتمدة على ا۳۲۸1 (لغة ترميز النصوص الفائقة))وسيلة من أجل اتصال التقارير والبيانات.تتيجح لك الوسوم"تنسيق الجدول 
tableformatting‏ "في ال 1۲M‏ ثل <ها>) تنظيم مخرجات جدولية(مستوية) دون الكثير من الجهد. من المؤكد »أن تنظيم جمبع السلاسل النصية المتعددة الحجم مع بعضها 
لبناء الصفحة هو تنظيم مزعج.ولكن توجد طرق بخصوص دلك أيضاً. ‏ ِ 
بالعودة إلى الفصل13ءفقد ناقشت فيه ×S|-١‏ (تحويلات اS×).طريقة‏ لاخذ بيانات معتمدة على ۷× وإعادة شحنها ضمن أي نموذج أخر تريده- متضمنا أعمال عظيمة من 
الفنء أو 1۲M‏ المصنوعة بإتقان.مهما يكن فإنك تحصل على اN‏ 1۲ء بالإضافة إلى أن لديك خيار عرض الطرق.تتضمن أكثر الطرق المباشرة تخزين ا1۲۷ المنتج في ملف 
ما للقرص.وبيدأً مستعرض انترنت المستخدم الافتراضي عرضه باستخدام أمر مثل التالي: 

Process.Start ("c: \temp\MyReport. htm") 
إذا كنت تريد أن يحتوي التقرير مظهر أكثر تكاملاً في تطبيقك.تستطبع عرض محتوى ا1۲ في أداة مستعرض ويب۲٥W5٥5۲ ط٠۷ .لقد عملنا هذا في كود المشروع العائد‎ 
.1۲ للفصل17عندما عرضنا تفاصیل بند المکتبة ک ا۷‎ 


يتم استخدام أساسيات تقديم النوافذ(۷۴۴)بشكل رئيسي لجعل واجهة المستخدم مكتظة بالاألوان والحيوية.ولكن يوجد قسم من التقنية لتوليد مستندات مستقرة معتمدة على 1× 
عرف ب 78×( مواصفات اM×‏ الور قيخSpecification Paper‏ اXM‏ ).كما أنك تستطبع إنتاج تقاریر باستخدام‌ا1 1۲ .تستطبع إنتاجها باستخدام معیار ۴8 ×.يتضمن 
الفصل18 مناقشة مختصرة عن ۷۴۴و ۴8S‏ ×.إذا أعجيك إنتاج التقارير باستخداء۴S×‏ .ر اجع التعليمات والمساعدة المضمنة مع الفيجوال أستوديو. 


تتضمن الفيجوال أستوديو مجموعة من الفئات في فضاء الاأسماء وہنااممهR Micros.‏ والذي بشكل خاص مصمم من اجل بيانات تقرير أ2 ۲٠0١۲‏ .الفئة الرئيسية في 
فضاء الأسماء هذا هي الفئة Repo r۲۷e we‏ (تم تعريفھا ک MicrosoftReportViewer‏ في ذاتية أداتها البديلة).عملياًء إنهما أداتان:واحدة من أجل نماذج ويندوز S‏ س0ل¡ 
۴0۲ والأخری من أجل نماذج الویب‌۶ ۴٠١۲۳‏ ط٥۷‏ .هذه الأدوات تكون معتمدة بشكل جزني على تقنية موجودة في خدمات التقریر لمخدم میکر وسوفت سکول Mi r080‏ 
SQL Server Reporting Services‏ وتستطبع أیضاً استخدام الأداة دون مخدم سکول 86۲۷6۲ 8Q1‏ . 

سيعمل مشروع المكتبة على استخدام الأداة Win Forms.Repor View‏ من أجل تقاريره الجاهزة(المينية داخلياً فيه١أ-اأاط‏ ).سنمضي معظم هذا الفصل في مناقشة هذه الأداة 
واستخدامها في تطبيقات نماذج ويندوز. ولن أناقش نسخة الأداة الخاصة بنماذج الويب هناءعلى الرغم من أنٌ استخدامها يوازي استخدام نسخة نماذج ويندوز. 

ستری کم ھو بسیط إضافة ادا Repo r۷1e wer‏ Microsofiإلی‏ مشروع موجود.ولکن الفیجوال أستودیو یتضمن أیضاً قالب مشروع جدید ٥اھام‏ ٥ا‏ †cھeزہ‏ ام new‏ والذي 
یرکز على |لأّداخںMicrosoftReporViewe‏ .يستخدم إنشاء مشروع "تطبيق تقارير ٩210ء‏ ام م۸ ءأاممهR‏ "جديد المعالج السحري للمشروع ٥ W74۲١‏ ز١٠۲م‏ لمساعدتك 
في تثبيت تقرير خاص.ويمكن أن تكون النتيجة النهائية تطبيق التقرير الكاملء أو تستطيع استخدامه كأساس من أجل تخصيص أبعد(أكثر). 


ااا لحك عى الئل الط الاك فة من الخال اوك هكون لها هة اة في ار ا ال ال اة مجو ف عة وة ن اشن اک س 
رور 2008 الرسفى اذا كت جذ على القيخوال رنسات فة فاك النسكة اة من الكرسغال رسوز تر الفضمن فع اللفة مذ أضدار اتا الا رلةسبب هذة اللا الطوراة 
اوا ا و اعا ها و ی و ا 

اا فال و م دوو ما ی ل عي " ماع الل e ESE e A Es ° BS obe‏ 
لأول مرة مع الفيجوال بيسك» ولكن تيدو شركة "متطلبات العملءاء# زا0 ”٠55‏ وا8 "تعتني به الآن.ولن أناقش الكريستال رييورتز أكثر في هذا الكتاب. 


لقد أصيحت الفيجوال بيسك لغة الماكرو الرئيسية لمجموعة تطبيقات ميكروسوفت أوفس المترابطة #اأناكمنذ موت 6أكة ¥6۲08 و لكنتي أنخدث عن الفيجوال بسك السابق 
للدوت نت الذي هو غير مدار.لحسن الحظ تستطبع أيضاً استخدام العالم المدار للفيجوال بيسك2008 للتفاعل مع تطبيقات ميكر وسوفت أوفيس.كيفية التفاعل مع أوفيس يعتمد على 
أياً منهما : مستند أوفيس أو تطبيق الفيجوال بيسك هو المركز الرئيسي للمستخدم. ‏ _ 
إذا كان هدفك تحسین تطبیق "مسار العمل55٥٣‏ انط ۴ه ٠٣نا‏ "باستخدام تطبيقات أوفيس المتنوعة كمدخل ٣ه‏ مإلى التطبيق_ على سبيل المثال إظهار مقدار (أشكال 
uresواf)‏ المبیعات الاخیرة من ضمن میکروسوفت ٥٥)‏ ااں۵ - خذ بناء تطبيق عمل أوفيس Office Business App|iC2 |0٩‏ (0BA).یمثل‏ تطبیق عمل اوفیسں 08۸ 

1 
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طريقة جديدة في تصمیم بر امج متكاملة باستخدام الفیجوال أستودیو.میکر وسوفت أوفیس ce‏ |0 50۴٥rءMi‏ .ميکر وسوفت شیر بوینت سرفیسس ˆ¡ Sh2re P0‏ 

evi‏ والأنظمة الأخرى ذات الصلة. 

من ناحية عالم الفيجوال أستوديو»يحدث عمل التطوير من خلال أدوات الفيجوال أستوديو الخاصة(الموجهة)لاوفيس |0۴ 0۲ sا00‏ ۲ Studio‏ اVisua‏ (تختصر ک ۷S10©‏ 
أو هاءvi)المضمنة‏ مع الطبعة الاحترافية وطبعة نظام الفريق للفيجوال أستوديو. 

إذا كان هدفك هو إنشاء وظائف إضافية ك١1-ك‏ 0ه ك"شريط مهام63۲ كه "خاص بك ضمن تطبيقات أوفيس»استخدم قوالب مشروع أوفيس"وظيفة إضافية ۸۵۵-۱١‏ "الجديدة 
atesاtemp‏ ectزroم A-1‏ المضمنة مع الفيجوال أستوديو.هذه التوسعات السهلة التطوير تتبح لك تخصيص ممار سة(معرفة) المستخدم وذلك بتخصيص مجموعة ميزات 
أوفيس .تعتبر "الوظائف الإضافيةء-١ ۸١‏ "أيضاً جزء من فستو 0ا۷ .وهي متاحة فقط ضمن الفيجوال أستوديو بطيعته الاحترافية أو نظام الفريق. 

لو تمكن المستخدم من الوصول إلى ميزات أوفيس بشكل غير مياشر فقط من خلال تطبيق الفيجوال بيسك (على سبيل المثالإذا كنت تريد من برنامجك أن بدا دمج بريد 
میکروسوفت ورد)ءاستخدم مجمعات ٣٤٥٣٥‏ االرئيسية iesاb Primary اnter0٥p Asse”‏ (P۱۸)لمیکر‏ وسوفت آوفیس المزودة من قبل میکروسوفت.توفر هذه المکتبات 
إمكانية الوصول إلى ميزات معينة لتطبيق أوفيس من خلال فضاء الأسماء S0, لثم.Microsoft. Office‏ .هذه المكتبات تربط كود الدوت نت إلى ميكروسوفت أوفيس»ولكن مع 
التركيز على كودك(كود الدوت نت الذي تكتبه) بدلاً من مستند أوفيس. 


لنمطي ما تبقى من هذا الفصل في مناقشة أدوات التقرير القياسية الموفرة في الفيجوال أستوديو.كما ذكرت سابقاًءيتم تضمين فئتي تقرير #۲ س٠0۲۲۷1م٠۸R‏ في الفيجوال 
أستوديو:واحدة من أجل تطوير سطج المكتب وأخرى لتطوير الويب.سأتحدث حول تشكيلة سطج المكتب فقط في هذا الفصل.والمصمم المستخدم لتطوير هذه التقارير لا يفرق بين 
هدف التقرير (سطح المكتب أو مستعرض الانترنت).توجد بعض الاختلافات في النشر(التوزيع)ءولكن علي ترك التوزيع عبر الانترنت كي تبحث عنه أنت. 

تتكامل ا داة بشكل مباشر مع خدمات تقرير سكول سرفر»عارضة جمبع الصفحات الناتجة بواسطة ذلك النظام المعتمد على المخدم. 

بما أننا نفترض أنك تستخدم سكول سرفر بطبعته السريعة من أجل التطوير الخاص بك(والتي لاتحتوي خدمات التقارير).سأركز بالمقابل على تقديم النمط "المحلياةعه! "للاداة. 
يتبج لك هذا عرض أي بيانات من أي مصدر تختاره على كل صفحة عرض للتقرير»ومن ضمنها مخدم سكول SQ) S6۲۷6‏ . 

لنسلك الخطوات المطلوبة لتصميم تقرير بسيط بشكل مرئي باستخدام الفئة ٣ه‏ سه۲۷هم۸R6.سنعمل‏ على إنشاء تقرير يعمل على جدولة السجلات في جدول رااراام۸لمشروع 
المكتية. الجدول الذي يحتوي بيانات حتى ولو لم تكن قد استخدمت مشروع المكتية حتى الآن.يعمل هذا بشكل أفضل إذا تتبعت على كمبيوترك مباشرةءلأن قراءة كيفية تصميم 
التقرير مشابه لقراءة كيفية إجراء عملية جراحية للمخ:والأكثر منفعة لو عملت ذلك بشكل عملي.ابدأً بإنشاء تطبيق نماذج ويندوز جديد. 


إضافة مصدر بيانات والذي يشير إلى جدول قاعدة البيانات ,۷ن۸ .فلقد عملنا ذلك سابقاً في الفصل العاشرءفي المقطع"إنشاء مصدر بيانات".اختر القائمة: بيانات هة 5 

> > إضافة مصدر بيانات جديدهءu۲هS‏ اه0 سه.N ۸d‏ . واستخدم المعالج السحري لتركيب مصدر البيانات من أجل البحث عن قاعدة بيانات المكتية 5۲2۴ا .عندما تصل 
إلى قائمة كائنات قاعدة البيانات»ضع علامة صح في الصندوق المجاور لجدولراا۷اه۸ » وانقر الزر"إنهاء ءأ١‏ ذ۴ "سيكون لديك الآن مصدر بيlنlت LibraryData Sean‏ 
.يبين الشكل التالي العناصر المضافة على مستكشف الحلول ١١۲دام×ع‏ ٣هااuاهS‏ ولوحة مصادر البيانات ۲٤٥s‏ uهS‏ ه0 بواسطة هذا المقطع. 


Solution Explorer 


B3 | ê | El 

E YWindowsApplication1 
A] My Project 
lH app. config 
E] Form1.wb 


f library.mdb 
ED libraryOataSet.xsd 


FH laî] lbrarypata5et 


+ EH Activity 
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استخدم القائمة:مشر وع ٥‏ #زه۴۲ > > إضافة بند جديد 6۳ا ۸۵١ 6W‏ لاإضافة بند"تقرير "جديد.يبين الشكل التالي بند التقرير في حوار إضافة بند جديد.تأكد من اختيار "تقرير 
Crystal Report "ıl" Report‏ "من القائمة. 


Add Hew Item - WindowsApplicationî 


Categories: Templates: 


4 Common Items Yisual Studio installed templates 
Code 


TT 
General . a 
Web trystal Report Report Wizard 
Windows Forms 
Reporting 
workflow 


iê My Templates 


لا 


search Online 
Templates... 


ûn empty Report File For creating a report using Microsoft reporting technology 


Name: Repart1 .rdlc 


انقر على الزر إضافة 44١‏ لأدراج التقرير ضمن المشروع.يظهر الملف ء/ك/.0/۲1م٠۴في‏ مشر وعك»ويفتح المصمم الخاص به بشكل آلي.و" 801-٥‏ "هو اختصار ل"لفة 
تعریف التقریر للعمیلا ٥ا٥‏ - Report Definition Language‏ ".وملف هذا النوع يحتوي محتوىی ا ×والذي يصف تخطيط التقرير المصمم بشكل محلي.يبين الشكل 
التالي المصمم الخاص بملف التقرير المضاف» زائد الأدوات في شريط الأدوات ١2طاههاالذي‏ يمكن من إضافة سطح تقرير.سأشير إلى التقارير المنشئة من خلال المصمم 
2 كفا WindowsApplication1 - Microsoft Visual Studio‏ 00 
File Edt Yiewy Project Build Debug Data Format Report Tools Test Window Help‏ 
a @- | # E ±= | FT BR û A,‏ @ لع ٠‏ ك ج و لج 
ا Report1.rdlc [Design] Formi.vb [Design] [ Start Page‏ „ : 
H EDE Rame 5 [iriver rarIrarI Sr IB ITIITBIT AI MII RI 3‏ 
k Pointer‏ 
jabÎ Textbox‏ 
x Line‏ 
I] Table‏ 
El Matrix‏ 
Rectangle‏ 
List‏ | 
lî] Image‏ 
Subreport‏ | 


HU Chart 


4 General 


۳ Error List | E] Qutput 


Ready 


“° ° ° ° ‘To create ã report {ayouk, drag ikems Fromm the tana arid Fields list ‘ard drop ther أ‎ 


1 
2 
a] 
4 
3 


sapado1g a 


إذا كنت قد كتبت تقارير في ميكروسوفت أكسس أو في أدوات تقرير مشتركة أخرىءمن المحتمل أنك على دراية بالتقارير المحزمة 02۸068۵ .هذه التقارير لديها "حزءكل١٣‏ 2ط 
"أو أشرطة كهم|٣اءتمثل‏ جزء من صفحة الطباعة.تتضمن الحزم رؤوس وتذييل 06۲5ه؟ 2٩۵‏ ۸6206۲5ءرؤوس وتذييل التقرير »مقطع تفاصيل السجل»ورؤوس المجموعة 
تاها اأفنخةهة تمع فاص الفدكلات فكل ر تي وختطةي عنها دن فل ارين بنا خط أفقي ملي على طول عرض الضف قن أغلى ل مغل الععحة عة 
يصطدم الخط بكل حزمةءيعالج التقرير الحقول في تلك الحزمة حتى ينتهي من معالجة جميع السجلات. 

تختلف تقارير ٥٤ا۸0‏ قليلاً عن التقارير المحزمة(المقيدةئا۲ممهإ كمل هط ).فيوجد فقط ثلاث أشرطة(حزم5ل١‏ 64 ):معنون(ر أس)الصفحةheader page‏ 
»مذييل(حاشية)الصفحة۲6۲٥0٥‏ #وهم .وكل شيء أخر يدعى "الجسم¥ك80 ".فبدلاً من إضافة حزم كك2 طللسجلات كsك۲هء٠ءوالمجموعاتءمنه۲و‏ .تعمل على إضافة 
حقول 5١|هاإلى‏ قطاعات البياناتء”٠/وع/‏ 44 .تعالج هذه المتحكمات(أو الأدوات) الخاصة السجلات المربوطة إلى التقارير طبقاً لشكل قطاع البيانات 0١‏ اوه ههل .توجد 


T7abاe.لودجلا‎ 

يجلب هذا القطاع ١٥و۲‏ عدد غير محدد من صفوف البياناتءW٥٠۲‏ هاه ءولكن مع مجموعة معرفة مسيقاً من أعمدة البیانات‌5٣٣”ںاهء‏ هھ .فهو مصمم من أجل التقديم 
لووف الک ری اوا ا ا لاا تی کل عفد عرض مد می ارک مات وکمزت بل عاد کل صف الكل سل فل انات الي 
allقJlب.Matrix‏ 

تاه هن اة كل الخو ل6 ا6و وكا هة رفت فزن فن عة ناتو فط الصوف 

القائمة.اءأا 

يوفر قطاع القائمة ١0اوه۲‏ ءا مقطع عرض حر النموذج ١0أءمء‏ yهامءdi free-form‏ لكل سجل قادمٍ ١۲١ء٤۲۴‏ و”۳iهع”|‏ .تستطيع إضافة أي عدد من الحقول أو أدوات 
عرض record sectionJجmلl gطق٩م alJ| display controls‏ . 

Chart. ططخۃةoall‎ 
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تستخدم المخططات ك۲ه۸ع |البيانات المحسوبة(المجمعة)من التقرير لإحضار خط شريط 4۲ط .ومخططات دائرة القطاعات النسبية(الدائرة المقسمة كنسب منئوية كأ٣2٣C‏ مام ( 
إلى المستخدم. 

يتم دائماً ربط التقارير من مجموعات بيانات إلى قطاع بيانات ١0و۲‏ هاه .إذا كان تقريرك يتضمن بيانات من مصادر بيانات متعددة مختلفة.فسير تبط كل مصدر بيانات إلى 
قطاع ١٥و۲‏ تقرير واحد بالضبط. وتظهر جميع الحقول(التقسيمات) في الحزمة 80۵¥.سنستخدم قطاع البيانات"قائمة ءا " من أجل عينة التقرير هذه. استمر الآن وأعمل على 
إضافة أداة "قائمة انا "إلى الحزمة"جسم 80١¥‏ " على سطح التقرير.تستطيع الآن إضافة بنود أخرى إما إلى سطح الحزمة نفسهاء أو إلى سطج الأداة"قائمة†ءاا ".البنود 
المضافة إلى أداة "القائمة انا "يتم إعادة معالجتها من أجل كل سجل في مصدر البيانات القادم.يمكن لهذه الينود إما أن تكون أدوات كاه٣أ٣هعمن‏ صندوق الأدوات ×هطاهم أو 
حقول قاعدة بيانات sلاعا؟‏ م2sةطهاaل‏ معروضة في لوحة مصدر البيانات‌ا6٣‏ 2م كعءu۲هS‏ هام0 .استخدم الجدول رإاا۷اا»۸في لوحة مصدر البيانات»اسحب حقل 

۴u Name‏ إلى سطح الاأداة"قائمة نا "ءيبين الشكل التالي المشهد بعد إتمام عملية السحب تماماً. 


Data Sources 


E ا‎ E Hê] IbraryDataSet 
jii; j i FFiPldSIFulName.valydg ir: E 
2] Ful ame 


ion Explorer ل‎ Data Sources || 


عندما سحينا الحقل من مصدر البيانات إلى أداة"القائمة ونا "عملت الفيجوال أستوديو على تأسيس اتصال بينهم.يشير حقل ٠2۳١56هاه0‏ لأداة القائمة 1ءاالآن إلى 
Data Set_Actiiy‏ Libraryا»‏ وهو اسم مصدر البيانات. وأضافت الفيجوال بيسك أيضاً أداة صندوق نص ×٥۲8×٠٣إلى‏ سطج أداة القائمة»وأضافت 

التعيير (مuاة۷. N2۳‏ اا s!۴لا۴e))‏ الذي يعرض محتوى ذلك الحقل من قاعدة البيانات من أجل كل سجل معالج. 

سأعمل على إعادة تحجيم أداة القائمةاءنا .صندوق النص×60 ×6 .وحزمة الجسم 0۵4۷ 8بحيث يشغل حقل صندوق نص ۸۳٣١‏ اال ۴جميع سطح التقرير.كما هو مبين في 


الشكل التالي. 
=FieldslFullM ame. yale |‏ آ 


التقرير جاهز الآن للاستخدام.عندما نصمم سطح التقرير»تكون الفيجوال أستوديو مشغولة في توليد ا ×وتخزينه في الملفه/ك1.۲٤0۲م۸€‏ . 


إن ملف ۸01-0 هو مجرد تعريف 1ا0 ×لتقرير ليس لديه القدرة على عرض نفسه.لعرض التقرير »يجب علينا إضافة أداة تقرير إلى الفورم أو صفحة ويب التي تعرف كيف تمزج 
محتوی تصمیم ا1 ×مع البیانات 24ل بشکل مناسب من مصدر بیانات معین.ار جع إلى الفورم ۴٥۲۳۸1‏ وأضف الاداة Viewer‏ Microsof|Reporإلی‏ سطج هذه الفورم من 
صندوق الأدوات(وهذه الأداة موجودة في مقطع التقارير و١‏ همه ۸R‏ لصندوق الأدوات×هطاه ها ).تتضمن الأداة المضافة زر وسوم الاستشعار الصغير" “5٣2۲٣‏ االق٣ء‏ 
button‏ ”sوهt‏ في الزاوية العلوية اليمينية".إن نقر هذا الزر يعرض نافذة سريعة بمهمات ۷W#۲ء0۲۲۷1‏ م۸6 N٧.والتي‏ تظهر في الشكل التالي. 

تجلب الاداة MicrosofiReporiViewerتجر‏ بة معتمدة على فورم لعرض التقارير.معظم الأداة عيارة عن مساحة فارغة حيث سيظهر التقرير.وهي تتضمن أيضاً شريط أدوات 
اbaاt0oايستخدم‏ للتنقل #أةو۷İة٠‏ خلال صفحات التقرير.يستطيع المستخدم أيضاً البدء بإخراج طبعة للتقرير من خلال هذه الأدواتءاه٣٣ه»‏ .إذا كنت لاتحتاج شريط أدوات 
أو واحدة من أدواته» استخدم خاصية التشكيلة ۸0W...‏ لداة MicrosofiNReportViewerخفاء‏ البنود الغير مطلوية. 


BEH 


8 ا 
Reporf¥iewer [ asks‏ ل 


Design a new report 


Cock in parent container 


عارض التقرير 8۲ ۲٠0۲٤ ۷۵W‏ شامل وغير معتمد على التقرير.إذا كان لديك عدة ملفات ۸01-٤٥‏ في مشروعك»تستطبع عرض أياً منها(واحد كل مرة)من خلال نفس عارض 
التقرير.لدينا الآن تقرير واحد في مشروعناءلذلك دعنا نصله۵/١۴600/11.۲)إلى‏ العارض باستخدام المهمة "اختر تقرير٤0۲معR‏ م0sمهطC‏ "كما هو مبين في الشكل السابق 
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وذلك من vieW6۲‏ ٣0م‏ eالزر‏ وسم الاستشعار ١0ط‏ وها امصء.أنقر أيضاً"ترصيف في الحاوية الرئيسية۲٠٣اه†‏ ١0ء Doc) ¡n paren‏ " في النافذة السريعة لتمديد 


التقرير على حجم الفورم. ١‏ 
إن كل من تقرير ۸01€ والبيانات ةلمن مصدر البيانات ٥ء٣۲‏ 0uء daa‏ وا داخ Microsoft ReportvViewer‏ جمیعها تنضم في عرض تقریر رائع بواسطة سحر تحزیم 
البيانات و١‏ ۵٣ط‏ هاه .عندما تربط التقرير باداة العرض.تظهر ثلاث أدوات إضافية eلی‏ lأفgرa: gagLibraryDataSet g« ActivityBindingSource «LibraryDataSet‏ 
مرجع إلى مصدر البيانات الفعلي الذي أضفناه سابقاً.أما الأداتين المتبقيتين تعملان على تضمين البيانات في الفورم بحيث يمكن تحزيمها إلى عارض التقرير. على الرغم من أنك لا 
تستطبع رؤيتها في المصمم»كود الفورم المخفي يعمل على وصل هذه الأدوات وتقرير ا۷ × إلى العارض. 
Me.ReportViewerl1.Dock = System.Windows.Forms.DockStyle.Fill‏ 
MEBO E Dalea SOME Eel lame > II OEIEVDUAESS EE AOE I EV‏ 
ReportDataSourcel.Value = Me.ActivityBindingSource‏ 
Me.ReportViewerl.LocalReport.DataSources.Add (ReportDataSource1l)‏ 
Me. ReportViewerl.LocalReport .ReportEmbeddedResource = "repOrt.Reportl.rdlc"‏ 
Me.ReportViewerl.Location = New System.Drawing.Point (0, 0)‏ 
Me.ReportViewerl1 .Name = "ReportViewer1"‏ 
Me.ReportViewerl.Size = New System. Drawing.Size (401, 246)‏ 
Me.ReportViewer1.TabIndex = 0‏ 


اضفط ۴5وشاهد نتيجة جهودك.يبين الشكل التالي النتيجة.لقد عملت على ضبط العرض بالنقر على زر شریط الادوات"تخطيط الصفحةاuام‏ رتا مو۴ ".ووضعت مستوى 
التكبير ١٥6۷ا‏ 20۳ إلى عرض الصفحة١الW۷i‏ موه۴ .كما ترى إن التقرير مناسب»ولكن نستطبع جعله أكثر أناقة . 


HE Formî1 


anage authors and names 
anage author and name types 
anage copy status codes 


anage media iyYpes 


anage SBrIBS 


أظن أن التقرير يحتاج إلى عنوان ذو معنى عند أعلى كل صفحة.ز ائد رقم الصفحة في الزاوية السفلية اليمينية.دعنا نعود على مصمم التقرير 801-٤٥‏ ونعمل على إضافتهم.حالما 
تكون هناك,انقر يمين على خلفية التقرير ۲١U١١‏ و)ءهط (وليس عل الجسم60۵۷ ءوالذي عليه علامات الشبكةء)۲ة" ١۲و‏ ).كما هو مبين في الشكل التالي. 
¥#EodY‏ 


=FieldsIFullName. yale 


Report Parameters... 


Page Header 


Fage Footer 


Properties 


من هذه القائمة اختر "ر أس الصفحة(أو معنون الصفحة۲ ١1٠20٠‏ مو۴ )"ومن ثم أحضر هذه القائمة مرة أخرى واختر "مذبيل الصفحة6۲أ٥٠۴‏ مو۴ ".كل حزمة جديدة تظهر 
لن ن ااي 
فا ا كانت فد الت الخضرة اة هن ر فكو أو نض وله فل كي اة رن رماتل أا دة الصن فة كي الا الا اة 
اظهار محتوی نص. أضف آداة صندوق نص ×۲۴×80 من صندوق الأدوات ltoolboxلى‏ كا المقطعين" رأس ومذيل "الصفحة.انقر داخل صندوق نص معنون الصفحة واكتب 
النالي: 

="'تقریر عن جدول LN‏ 


تستطبع استخدام لوحة الخاصيات لضبط مظهر هذه الأداة.متضمنة خط العرض. 
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في صندوق نص المذيل اكتب هذا النص: 

="ãحفص"‎ & Globals!PageNumber 
8؟لقد عملت على بناء التعبیر بشکل‎ Gاobaاs!‎ Page Nun per يتضمن شبه الكائن كءاهطهاBعدة أعضاء تستطبع استخدامها في التقریر.ولکن کیف عرفت استخدام: "صفح"‎ 
.للوصول له »انقر يمين على أداة صندوق النص ×٠18×٠٣واختر تعبير ١55¡0ه١م×ع من القائمة المختصرة.يبين الشكل‎ ع×م۲هءا0٥۸‎ ٤۵0٥۲ مرئي باستخدام محرر التعبیر‎ 
التالي هذا المحررءفهو يتبج لك بناء تركيب باستخدام قوائم من الدوال وأسماء الحقول.يحدث لأن تكون الدوال الفعلية نداء(حث) لدوال الفيجوال بيسك.‎ 


گگگ 
< سا Expression‏ 


Build an expression using visual Basic language syntax: 


=I daa" & GIobals !FageNurber 


تجمبع البيانات شائع في التقارير المطبوعة.لإضافة تجميع لتقريرناءنحتاج إلى تضمين أداة القائمة ءا االموجودة(سجل التفاصيلك 0۲ء۴٠‏ اأهأهل ٥1ا‏ )ضمن أداة قائمة ءا 
أخرى(المجموعةم داهو 8٠ا‏ ).ووضع الخاصيات المتنوعة على أداة قائمة المجموعة كنا ماهو لتحديد طريقة تجمبع البيانات. 
لنعمل على إضافة أداة قائمة أخرى(مسماة 12ءا)إلى جسم التقرير»وامنحها ضعف ارتفاع أداة القائمة الموجودة(المسماة 1اءا)ومن ثم»اسحب 11ءاا(سجل التفاصيل اأهأهك 
dاreco)لضمن‏ 12ءا(المجموعة الجديدةم اتاو سه٣‏ ٥۸ا‏ ).ضعها باتجاه الأسفل.سييدو تقريرك كما في الشكل التالي. 
لتركيب المجموعة. انقر يمين عليها واختر الخاصيات كءاام مه۲٥۴‏ من القائمة المنسدلة.يظهر نموذج خاصيات القائمةءاا .على تبويبها"عام ا۲2 66٣۸68‏ ".انقر الزر "تحرير 
مجموعة التفاصيل ماهو ءانهامه ٤اك‏ ".والذي يضع التجمبع وأماه۲و .على الخاصيات "ترتيب و”ذااهS‏ " و"تجميع و”امدهإ "التي تظهر »أدخل النص التالي ضمن 
الصف الأول ٥W‏ st٣ا؟‏ لحقل"تجمیع على 0۸ Group‏ ": 
=Left(Fields!FullName.Value, 1)‏ 
Page Header‏ #¥# 
"كقرين عن جدول النش "= ق 
Endy‏ #¥# 
SS E E O E‏ 


واا ا ا ی ا ا ا ا ا ا ا ا 
=FieldslFullName.walue AE‏ ; ; 
GREER EERE RRR RRR REET FERRER RRR REE RRR REE,‏ 

¥ Page Footer 


: =" &, GlobalslPageNumber OEE E EEE 
هذا التعبير يخبر أداة 12ءاتجميع نتائج تفاصيلها بواسطة الحرف الأول لحقل الاسم الأول.‎ 
:" Document map label "JقazJ| على نفس هذه الفورح« أضف النص التالي إلى‎ 

="Letter: " & Left(Fields!FullName.Value, 1)‏ 
إن "تشبيك مستند "2P‏ †eصuع0ل‏ "يمن قائمة رابطة فائقة(ر ابطة مدمجة )١١ا٣‏ 8م۸۷ ) ضمن المجموعات المختلفة للتقرير.عندما نشفل التقرير بعد قليل»سنرى هذا الربط 
إلى اليسار تماماً على سطج عرض التقرير. 
السجلات في جدول بااناءهيتم ترتييها من أجل الراحة بالنسبة للمبرمج.ولكن من المحتمل أن يطلب مستخدم التقرير رؤيتها مرتبة بزي مقبول نوعاً ما.انقر على التبويب"ترتيب 
Sorting‏ ".وأضف النص التالي إلى الحقل"ترتيب على 0۸ S0۲٤‏ "في عمود التعبیر ٣essi0ا Exp‏ : 

=Fields!FullName.Value 
ان۴ .انقر الزر "موافق 0 "وارجع إلى سطح التقرير.‎ ١ه‎ ٣٥ كما تتوقع»هذا سيرتب الييانات بواسطة حقل‎ 
إلى أداة التجميع12ء:ا .ضعها في الزاوية العلوية اليسارية للأداة‎ ٣٠×8٠× سنيقى بحاجة لاضافة شيء ما يجعل كل مجموعة أفضل بشكل ملحوظ .أضف أداة صندوق نص‎ 
:)۷جاuم الأم»واكتب النص التالي ضمنها(أو ضمن خاصيتها‎ 
=Left(Fields!FullName.Value, 1) 

ولقد عملت أيضاً على وضع خاصية ru٤!‏ و8Backإلى‏ "أسود)ءaا8‏ ".وخاصية "اللون ۲اه "إلى أبيض6اأ۷ .وخاصية "الخط ۴٠۸۲‏ "إلى"عادي 
N Normal‏ إر يArialJ‏ .12نقطة 12pt.غامق B01‏ "من أجل المظهر فقط . 
تشغيل التقرير يمنحك النتانج الميينة في الشكل التالي.2حظ ر بط المستند على طول الحافة اليسارية للنافذة.وعناوين الحرف المفرد المجمعة قبل كل مقطع مجموعة. 
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Manage barcodes 


Manage holidays 
Letter: 


Manage patron groups 


Process and accept fees 


Perform daily processing 


Check out library items 


Check in library iterms 


من المحتمل أن الميزة الأسهل لتقارير ۸01-٥‏ هي أنه يمكن للعديد من الخاصيات لبند تم وضعه على سطح التقرير تضمين تعابير شرطية.وهذا يعني أن بإمكانك تعديلها بشكل 
شرطيءيعنيء أن الخاصيات المرنية لأداة صندوق النص ×ه8×٠۲تعتمد‏ على قيمة حقل في السجل الحالي. 

في مقطع مشروع هذا الفصل»سنكتب تقرير يستخدم تواربخ استحقاق الدفع 5هل عل للينود المستخرجة حالباً.إذا كان البند مستحق الدفع سابقاً.فأريد إظهار تاريخ الاستحقاق 
بالأحمر.عادة خاصية اللون 0۲اه لأداة صندوق النص ×ه۲8×٠٣‏ (التي هي لون خط الأدوات)هي أسود>ه|ا8 ..لأجول ذلك الحقل يستجيب لينود مستحقة الدفع.سأعمل على 
تبديل"الأسود"بالتعبير التالي: 


=llf(Fields!DueDate.Value < Today, "Red", "Black") 


على الرغم من أنه شائع كثيراً إنتاج التقارير من قاعدة البياناتءتستطبع عملياً استخدام بيانات من آي مصدر.عند استخدام الاأداقwe‏ ء۷٤0۲م Microsoft‏ .فاي مصدر بیانات 
ينفذ واجهة ٩اط۳6۲۵ں"ع۱‏ هو جید بشکل کافي. وهذا یتضمن جمبع التجمعات5٣٥ااءم‌اام‏ .المصفوفات۲۲۵۷5ھ .ونتائج استعلام لینکو ۱۵ | .فالتقریر لیس بتلك 

الانتقائية (الحرص۷عء ام )ءطالما أنه تم تنسيق البيانات كما هو متوقع.من أجل التقرير الذي عملنام بإمكاننا التخلص من ۸ء اال الييانات الفعلية وتوفير بيانات مزيفة خاصة بنا.يجب 
علينا إتباع القليل من القواعد لجعله يعمل: 

. عندما سحبنا الحقل ١اا‏ ۴.راvناعءهمن‏ مصدر البيانات إلى سطح التقرير». حصل التقرير (عملياًء أداة القائمة 1511ا ) على الفكرة البسيطة التالية أن جميع البيانات يجب أن 
تأآتي من مصدر بیانات مسمی ا۷ا A_هSهاة0رماطنا.وأي‏ مصدر بيانات نستخدمه مكان البيانات الحقيقية يجب أن يحتفظ بهذا الاسم. 


.مصدر البيانات المزيف يجب أن يتضمن حقل# 1١ا۴‏ »بما أنه هو الحقل الذي يتوقعه التقرير. 
هذه القواعد ليست بهذا السوء.لذلك إليك ما نحتاج إليه من أجل العمل:إنشاء مصدر بيانات مزيف ۴ء۲ ا0ء هاهك همها .اعتراض سبيل أمهء6۲”االتقرير تماما قبل محاولته 
الحصول على البيانات من قاعدة بيانات المكتبة.وإدخال بياناتنا الخاصة عوضاً عنه. 
من أجل مصدر البيانات المزيف»سنحتاج إلى فة تتضمن على الأقل الحقل 4٥e‏ ااں۴. 
Public Class FakeActivityRecord‏ 
Private StoredID As Long‏ 
Private StoredFullName As String‏ 
Public Sub New (ByVal whatID As Long, ByVal whatFullName As String)‏ 
StoredID = whatID‏ 
StoredFullName = whatFul1IName‏ 
End Sub‏ 
EuUSlIG Eroberly ID() AS Tong‏ 
Ee‏ 
Return StoredID‏ 
End Get‏ 
Set (ByVal value As Long)‏ 
StoredID = value‏ 
End Set‏ 
End BrOpPperty‏ 
Public Property FullName() As String‏ 
Cek‏ 
Return StoredFul lIName‏ 
End Get‏ 
Set (ByVal value As String)‏ 
StoredFullName = value‏ 
End Set‏ 
End Property,‏ 
End Class‏ 
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الحقول المعروضة يجب أن تكون خاصيات. وليست مجرد حقول(متغير ات)عامة.فعارض التقرير لا يميز حقول الأعضاء القياسية. 
إذا ألقيت نظرة على الود المصدري ل ۲۳۹1٥۴.ستجد‏ الكود التالي وقد تم إضافته إلى معالج حدث تحمیل الفورم ۴٥۲۳_102۵‏ عندما عملنا على وصل مستعرض التقرير مع 
تقریر .8R01٥‏ 
Me.ActivityTableAdapter.Fill (Me.libraryDataSet.Activity)‏ 
Me.ReportViewerl.RefreshReport ()‏ 


حيث أن السطر الأول يحمل البيانات من جدول قاعدة بيانات المكتبة ويعمل على وصلها بالتقرير في السطر الثاني.نحتاج إلى استبدال هذه الأسطر المولدة من قبل المعالج السحري 
بكود يقطع الطريق على اتصال البيانات الحقيقية. 


Create a fake table of fake records.‏ ا ا 

Dim fakeSource As New Collections.Generic.List (Of FakeActivityRecord) 

Add each of the fake records.‏ ج چ 
fakeSource.Add (New FakeActivityRecord (1, "Do some work") )‏ 
fakeSource.Add (New FakeActivityRecord(2, "Take a nap"))‏ 
fakeSource.Add (New FakeActivityRecord(3, "Write a program") )‏ 

Ia The report was already bound to the true 

' data source. Delete it. 
Me.ReportViewerl.LocalReport.DataSources.Clear( ) 

Build a new data source. Remember, it must have‏ سض ا 

' the same name. 

Dim fakeReportSource As New Microsoft. Reporting.WinForms. ReportDataSource 
Fa ESERO DOE ES OWE GE lame = MICA EASE E E CEY 
fakeReportSource.Value = fakeSource 

e Connect the data source to the report, and we're done. 
Me.ReportViewerl.LocalReport.DataSources.Add (fakeReportSource) 
Me.ReportViewerl.RefreshReport ( ) 


بين الشكل التالي التقرير مع البيانات المزيفة على المستعرض. 


HE] Forma 


EI 4ا‎ 3 E A = | o» 


#4 Report1 


شقرتن جذوام الفت لد 
Letter: T‏ 
Letter: WW‏ 


Do some work 


Take a nap 


إن استبدال البيانات في المقطع السابق جيدولكن إذا كنت تريد تصميم تقرير لايعتمد على قاعدة بيانات على الإطلاقتستطبع عمل دلك. أيضاًءوذلك بتوفير مصدر بيانات خاص 
بالكامل.تحتاج تقارير ۸01٤٥‏ نوع ما من تخطيط مصدر البيانات وقت التصميم. ما لا تستطيع عمله فقط هو توفير بيانات خاصة بالكامل أثناء التشغيل عند تشغيل التقرير. ولكن 
تستطبع توفير تخطيط خاص معتمد على فئة في تطبيقك.من أجل الفئة »سنر تبط بالفئة ٠٥٥۲۵‏ ۸/إاا۷ )»ه۴ التي عملنا على إنشاءها منذ قلیل.ومن ثم سنصمم مصدر بیانات من 
هذه الفئة.اختر القائمة بيانات Ad New Data Source > > 02a‏ إضافة مصدر بيانات جديد.عندما يظهر المعالج السحري لتركيب مصدر البيانات .ففي الماضي كنت دائماً 
تختار قاعدة بيانات 25٥‏ طهةاة0كمصدر للبيانات.في هذه المرة»اختر "كائن†ء 6زط0 " كما هو مبين في الشكل التالي. 

عندما تنقر على زر "التالي "٥×‏ ".يظهر تنظيم هرمي بكل الفئات الموجودة في تطبيقك.مدد الفئات ومن تم ابحث واختر llلفiة .FakeActivityRecord‏ 


Data Source Configuration Yizard 


Choose a Data Source Type 
رھ ۔‎ 


where wîll the applîcation get data from? 


dÊ I 


Databases Service 


Lats you choose an object that can later be used Io generate data-bound controls 


الل الاي ارون اقفارين, Mhm76‏ 

انقر على الزر إنهاء.تظهر الفئة ۵١١٥ء‏ ٠۸/إا۷اا۸ه۴akكمصدر‏ بيانات في لوحة مصدر البيانات. 

تستطيع الآن سحب وإسقاط الحقل ١4٣١‏ اانا ۴لمصدر البيانات على سطج تصميمي لتقرير ۸01-٥‏ جديد.أضف تقرير جديد لمشروعك.واتيع نفس الخطوات التي استخدمناها 
سابقاً لتصميم التقرير الأول.هذه المرة, استخدم مصدر البيانات ١۲٥ء٠‏ ۷۸نا ۴a۸‏ بدل مصدر البيانات 86هاة٥۷ه١طاا.لاختبار‏ هذا التقرير الجديد »يمكنك أنشاء مشروع 
جديد وإضافة الأداة Microsoft ReportViewer‏ إل الفورم وترصیفها على سطح الفورم.ولکن لا تعمل على ربطها بالتقریر 8۸01٥‏ .وھذا يجعل الأشياء أوضح بما انه لایوجد 
أدوات تحزيم مصدر و أي شيء أخر. ومن تم اعمل على إضافة الكود التالي إلى معالج حدث تحميل 4١4٥1االفورم.(ولكن‏ لا تنسى إضافة لف FakeActivityRecord|إلa‏ 


"Report1 "والتقرير"‎ عeمoإt‎ cost onda as0 u ce المشروع الجديد).كما سترى فقد علمت على تسمية المشروع الجديد"‎ 
Erivale SUD HOM Load (BVUSl Sender AS SVs eem. OOIECE, BVVIlL € AS SYS. EVENEAEIS) HINILES MYESASE LOA 


Tink EO Eme RDC EepOrE desion‏ دص ا 
Me.ReportViewerl.LocalReport.ReportEmbeddedResource = "reportcostomdatasource. Reportl1l.rdlc"‏ 
Create a fake table of fake records.‏ ڪچ .1 


Dim fakeSource As New Collections.Generic.List( Of FakeActivityRecord) 

Add each of the fake records.‏ ص ا 

fakeSource.Add (New FakeActivityRecord(1, "Breakfast")) 

fakeSource.Add (New FakeActivityRecord(2, "Lunch") ) 

fakeSource.Add (New FakeActivityRecord(3, "Dinner") ) 

Build a new data source. Remember, it must have‏ حح ا 

' the same name. 

Dim fakeReportSource As New Microsoft. Reporting.WinForms.ReportDataSource 


fa EeREPDOE E SOME GCE. Name > ECBO EEOS EOMISAEISOUEEE HS KERE EIS EYVERECOSEEL, 
fakeReportSource.Value = fakeSource 
ا‎ Connect the data source to the report, and we're done. 


Me.ReportViewerl.LocalReport.DataSources.Add (fakeReportSource) 
Me.ReportViewer1.RefreshReport () 
Me. ReportViewerl.RefreshReport () 

End Sub 


إنه مشابه کثيراً للكود الخاص السابقءعلى الرغم من آن مصدر البيانات الان reportcostomdatasource_FakeActivityRecordg®‏ .لقد علمت على حفظ 
نسخة من عمل هذه التقارير »اذهب إلى دليل المشروع للفصل21 وراجع هذه التقارير. 


عندما غادرنا مشروع المكتبة للمرة الأخيرة تركنا مستند مجموعة الموارد التقنيةءوهي تحتوي على خمس تقارير جاهزة: 

ltems Checked Out RepO1†.aجرënلl‎ دونيلاl .التقرير 1#:تقرير‎ 

.التقرير 2#:تقرير الينود المتİÎخرö‏ |ellعlدReport.ö Items Overdue‏ 

.التقرير 3#:تقرير البنود |lزمغقودöة.ئRep0r Items Missing‏ 

Fines Owed by Patrons Report.jئilڊjJl‎ ale .التقرير 4#:تقرير الغرامات المستحقة‎ 

.التقرير 5#:تقرير إحصاءات قاعدة بيانات |alكıiة.†Rep0F Library Database Statistics‏ 

سنعمل على إضافة هذه التقارير الخمسة إلى المشروع في هذا الفصل. قبل كتابة أي كود.ءنحتاج إلى استكشاف كيفية الحصول على البيانات.بما أن البيانات ستأتي من قاعدة بيانات 
المكتبةءما نحتاج إليه صناعة عبارة سكول من أجل كل تقرير سنعمل على ربطه إلى التقرير المصمم. 

التقرير الخامس"الإحصاءات" سيخبر عن أشياء مثل عدد البنود عدد الزبائن»وقيم إحصائية أخرى من قاعدة بيانات المكتبة.بما أن هذه البيانات تأتي حقيقةً من عبارة سكول واحدةء 
سنعمل على استخراج البيانات من قاعدة البيانات ونبني مورد بيانات خاص يغذي التقرير. 


يعمل التقرير الأول" الينود المخرجةااه ١#)ععمء‏ sصmمt¡‏ ". على جدولة اسم الزبون وعنوان البند من أجل كل بند قيد الإخراج من قبل زبون.يتضمن الجدول"الزبون ١٣و۴‏ 
"(من أجل الحصول على اسم الزبون). والجدول"نسخة | لزبون مه٥٤۸‏ ٥ه‏ "(حدث الإخر اجااه)ععمء )ءوالجدول "نسخة بند رمه ٠٠.٥‏ "(البند الفعلي الذي تم 
إخراجه)ءوالجدول"اليند المسمى ۳ءاال١ه٠ه.‏ "(حيث يظهر عنوان البند)»سنضمن أيضاً الجدول "نوع كود الوسيطة همر 1هكه ٥٥۵6۸۷‏ ".والذي يخيرنا فيما إذا كان البند كتاب 
أو سيدي C0‏ .أو نوع وسيطة أخرى. 

تتضمن منصة إدارة ميكروسوفت سكول سرفر السربع ssئre crs ft SQا| Server Management Studio Exp‏ Mمصمم‏ استعلام مرئي نستطبع استخدامه اتصمیم 
الاستعلام.يبين الشكل التالي الجداول الخمس المطلوبة كما تم ربطها مع بعضها بواسطة المصمم. 


E PatronCopy آ1‎ Ëğ ktemCapy J MNarmedIterm 1 
* All Columns] * (All Columns) 
سلا چ‎ pD 
[LastName > Patron ItemID 
FirstlJarme ItemCopy |_lCopyurmber 
لا‎ Lazar Checkout Description 
Ackiye |_|Renemal 
Lommenks DueDate 
AdminMessage CherkIn 
| Barcode Returned 
|_|Password [Missing 
Email 
Phone [_[FulMame 
Ll LherckoutDays 
RenewDays 
Renew Times 
[_lDailyFine 
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فيما إذا كنت تستخدم مصمم الاستعلام أو تبني عيارات سكول يدوياًءستنتهي بشيء مشابه للتالي»وهذا ما سنستخدمه في تطبيق المكتية: 
Report #1: Items checked out report. */‏ ڪ صصص 5 
SEG PA.LastName + ', ' + PA.FirstName AS PatronName, PA.Barcode AS PatronBarcode,‏ 
PC.DueDate, IC.CopyNumber, IC.Barcode AS ItemBarcode, NI.Title <‏ 
CMT.FullName AS MediaName‏ 
FROM EAEEON AS BA MONE ION‏ 
Fat HONCOPY AS EC ON PA TD . BCE EAEEON INNER OLN‏ 
LEEMCOS AS LCE ON EC TESCO = LCE TD NES ON‏ 
Namedu Etem AS NI ON TE ICemID NI ID INNER VOIN‏ 
CodeMediaType AS CMT ON NI.MediaType = CMT.ID‏ 
WHERE (PE .Réeturned = 0) AND (BC.MiISSINnG = O0) AND (IC.MiSSINO > OC‏ 
ORDER BY NI.Title, IC.CopyNumber, PA.LastName, PA.FirstName‏ 
يربط هذا الاستعلام جميع الجداول»ومن ثم يستعلم عن كل سجل لم يعمل على إعادة قيمة(0 = ۲٣٥۵‏ ںهR.٥۴).ويتجاهل‏ أي بند تم تleيم"مفقgد") PC.Missing = 0 AND‏ 
0 = و اءMis./).وهذا‏ الاستعلام سيقود التقرير في النهاية..ولكن حالياًءاعلم أن التقارير ۸01-٥‏ لتحتاج إلى عبارة سكول أو جدول قاعدة بيانات من أجل مخطط 
التقرير.نستطبع أيضاً بناء مخطط ملائم يدوياً باستخدام فئة.وييدو هذا أوضح بما أننا لانريد أن يكون لدينا الكثير من الحقول المرتبطة بمجموعة البيانات المنثورة على طول الكود 
المصدري للمشروع.(مورد البيانات ٤56هاة٥رءه۲طناالذي‏ عملنا على إنشاءه في مثال التقرير السابق عمل على إضافة أربع ملفات مصدرية وحوالي 50كيلوبايت من الكود 
المصدري للمشروعءبدون احتساب التقرير. أما مصدر البيانات المعتمد على فنة لايعمل على إضافة أي كود ما عدا تعريف الفئة نفسها والقليل من ا ×في ملف ).)851-€٥‏ 
أما بالنسية لمخطط مورد البياناتنستطبع استنتاجه من الشرط ١٥٤۴-ا8Eلاستعلام‏ سكول.إذا كان علينا تصميم فنة مع التخطيط الموافقءسييدو كما يلي(بدون كود تفاصيل 
الخاصيات). 


Class Report1Schema 

ublic Property PatronName () As String 
uUOLLE EBEOPEEEY EAEEONEAEEOde AS SEEING 
ublic Property DueDate As Date 

ublic Property CopyNumber As Integer 
uUblIiG BEOperEY llemearceode AS SEEING 
UDINE EBOBEEEY IIEle AS GERIM 

ublic Property MediaName As String 

@ ل 


التقريرين التاليين من " البنود المتأخرة الإستعادة" و"البنود المفقودة" بالنسية ليءمخطط التقرير الأول هو ما تريد رؤيته بالضيط في التقريرين التاليينءلذلك سنستخدم نفس عبارة 
سکول تماماً.ما نحتاج عمله هو تفیر الشرط ٤R۴٤1.من‏ أجل تقرير البنود المتأخرة الإعادة, استخدم شرط ×“1٤۸۴٤‏ التالي: 


ll ao GO O O O O ES) 


WHERE PC.Returned = 0 
AND PC.Missing = 0 
AND IC.Missing = 0 
AND PC.DueDate < GETDATE( ) 
سیستخدم تقریر البنود المفقودة شرط ع٤۸٤۷1 التالي:‎ 
WHERE PC.Missing = 1 
OR IC.Missing = 1 
يعر التقرير الرابع كمية الغرامات المتبقية المستحقة على زبونءلذلك سيتطلب منا تخطيط مختلف.إليك عبارة سكول والتي تستخدم بعض ميزات تجمبع الإجمالي.‎ 
----- */Report #4: Fines owed by patron/* . 
SELECT PA.LastName + ', ' + PA.FirstName AS PatronName. 
PA.Barcode AS PatronBarcode. 
SUM(PC.Fine - PC.Paid) AS FinesDue 
FROM Patron AS PA 
INNER JOIN PatronCopy AS PC ON PA.ID = PC.Patron 
GROUP BY PA.LastName + ', ' + PA.FirstName, PA.Barcode 
HAVING SUM(PC.Fine - PC.Paid) > O0 
ORDER BY PatronName 
إليك التخطيط الذي يوافق التقرير الرابع:‎ 
Class Report4Schema 
BUS IE EOE EY EalEonNanme () AS SERIN 
BUDI1CE EEOPEEEV BACEOREBALEOdE AS SEEING 
Public Property FinesDue As Decimal 
EHNA CLIaSS 


أما من أجل التقرير الأخير»سنستخدم فقط تخطيط مع قيمتين من نوع السلسلة النصية:اسم الأحصائية. والقيمة المتعلقة بها.إليك تخطيطها: 
Class Report5Schema‏ 
EUT E EFOBEE EV EME YName () AS SEEFINO‏ 
EUDIIGE EFOPeEEY ENEEYValuUe AS SEEING‏ 
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EMA CISSS 


حسناًيكفي تحضير.لندخل إلى المشروع ونبدأ بكتابة الكود . 


عملت على إضافة الملف طs.۷ة٣٣ءاء۲SاممRe‏ إلى المشروع»وهو يتضمن المخططات الثلاث المستخدمة من أجل التقارير الخمسة المينية داخلياً.راجع المشروع لتلقي نظرة 
على هذه الملف . 
ما تحتاج إليه الآن بعد بناء مخطط الفنات في المشروع بناء المشروع قبل أن تتمكن من استخدام هذ الفثات في تقارير ۸01-٥0‏ كمصادر بيانات .في مشروع المكتية.اعمل على 
بناء المشروع الآن من خلال القائمة بناء ١ا8‏ > > الأمر بناء المكتبة ۷٣2٣ط١ا‏ لاأا8.جميع هذه المخططات يجب أن تظهر عندئذ كموارد في لوحة موارد البيانات(شاهد الشكل 
التالي).إذا كانت لوحة موارد البيانات مفلقة اعمل على فتحها من خلال القائمة بيانات 4ا04 > < أظهر موارد .Show Data Sources cilı‏ 
Data Sources‏ 
AE EE‏ 
SETI ReportschemnaPatronEines‏ 
FinesDue‏ 
PatraonBarcode‏ 
Patronlarne‏ - 
.-ğ Reportschemas‏ 
[ıa2] Zopy¥Jurmber‏ 
{E5] GusGate‏ 
ItemBarcade‏ 
MedialYame‏ 
-[abe] PatronBarcode‏ 
-labe] Patron Jame‏ 
[abe] Title‏ 
E ReportschermaStatistics‏ 
[abe] EntryJarmea‏ 
[abe] EntryYaluıe‏ 


2 Ea Server. ۹ [3 Toolbox 


سأعمل هنا على بناء خمس تقارير ۸01٥‏ جاهزة : 


ينفذ هذا الملف التقرير رقم1ءتقرير"البنود المخرجة أو المستعارة".وهو يستخدم تخطيط الفئة ك ema ۴ a٣٥!"‏ ortScnمRep.ويتضمن‏ تلاث أعمدة في قائمة البيانات 
الرئيسية:اسم الزبون/كود التعريف» اسم البند/البار كود/التفاصيلوتاربخ استحقاق الإعادة. من أجل حقل اسم البندأردت إحضار معلومات إضافية عندما تكون متاحة. إن كل من 
اسم البند رقم النسخةءونوع الميديا قيم مطلوبةولكن كود تعريف بند هو اختياريءإليك التنسيق الذي أفضله: 
اسم البند( #رقم النسخةءنوع الوسيطةءكود التعريف(.)cO0de°ڵB2 Item Name (#CopyNumber, MediaType,‏ 
للحصول على النتيجةءكان علي جمع حقول الموارد المتنوعة مع بعضهاء واستخدام الدالة الشرطية(18)لتضمين كود التعريف بشكل اختياري وفاصلته: 
=Fields!Title.Value & " (#" & CStr(Fields!CopyNumber.Value) & ", " &‏ 

Fields!MediaName.Value & Ilf(IlsNothing(Fields!ltemBarcode.Value), "",", " & Fields!ltemBarcode.Value) & ")" 

كما ذكرت سابقاً»حقل تاربخ استحقاق الإعادة #أةك عن لديه تعبير في خاصية اللون تحول لون الخط إلى أحمر عندما يكون البند متأخر الإعادةهں ل0۷6۲ . 


يعمل هذا التقرير على إظهار قائمة بالبنود المتأخرة الإعادة في النظام.بما أن كل شيء سيكون متأخر» عملت على وضع حقل تاربخ الإعادة لأن يستخدم بشكل دائم لون الخط 
الأحمر.بدل العنوانءإن التقرير مطابق لتقرير البنود المخرجة(أو المعارة). 


يعمل هذا التقرير على إظهار قائمة بجميع البنود المعلمة على أنه تم فقدانها.حتى ولو كان المخطط يتضمن حقل تاربخ استحقاق الإعادة.لن استخدمه في هذا التقرير.باقي التقرير 
مطابق بشكل أساسي لتقرير البنود المخرجة. 


يعمل هذا التقرير على إظهار قائمة بجميع الزبائن الذين ما تزال عليهم غر امات مستحقة.وكمية الفر امة المستحقة.ويستخدم تخطıط‏ illة .ReportSchemaPatro" Fines‏ 
الحقل الذي يعرض الغرامات لديه " € "في خاصية التنسيق ٥١١١3‏ ۴.تنسيق الكود هذا يجبر قيمة عشرية 2٣ء‏ 6ل لعرض العملة 011۲۲8۴۸٤٥۲۷‏ باستخدام الإعدادات 
الاقليمية(أو التقافية ۲٠‏ الات )على النظام المحلي.وخاصية التنسيق هذه تستخدم نفس الأكواد المستخدمة في الطريقة 2٣۱۸9.۴0۲۳٣†S؟.‏ 


يعرض التقرير الخامس إحصاءات السجلات من بعض الجداول في قاعدة بيانات المكتبة.وهذا هو التقرير الوحيد الذي يستخدم تخطıط‏ llلفiة .ReportSchemaStatistics‏ 
يعرض التقرير نفسه فقط نصين في كل سجل:اسم وقيمة 8 ا۷21 2 ٣.۳6 4۸٩١‏ .ويعتمد على الكود المستدعي لتنسيق خاصية الحقول تلك. 


حان الوقت لإضافة أداخ lo. MicrosoftReportViewer‏ أن داخ MicrosoftReportViewer‏ واحدة يمكنها أن تعمل على إظهار أي نوع تقرير 01-٤٥‏ ۸R.سنعمل‏ على إضافة فورم 
واحد لمعالجة جمبع التقارير المبنية داخلياً(أو الجاهزة). 

ضف فورم جدید وسمیھا ie we۲۷6‏ 1۸۷ا¡ ReportBu‏ إلى المشروع.وضع خاصیة النص ٥×‏ ٣لھا‏ إلى "تقریر |ٹمکتيةReport Library‏ "وخاصية WindowState‏ !ل " 
Maximized‏ ".و أيضاً »حمل أيقونة المشر وع (0٥/.800۸)إلى‏ الخاصية ١٥٠ا.ستجد‏ نسخة من هذا الملف في دليل المشروع.إذا أردت»تستطبع تحجيم الفورم لسبب ما فنقطة 
البداية من أجل التقرير (استخدمت 400 ,680)ولكن كل تقرير سيبدأً باستخدام الحجم الأكبر عندما يتم استخدامه. 
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أأضف اداخ eweMicrosoftReportViewerاö ReportContent‏ إلى الفورم»وضع خاصية 00٥‏ إلى ١اذ۴.‏ وضع الخاصية ١8ac)8u†)0سsh0والخاصية‏ 
.False İطخ alJ|ShowDocumentMapButton‏ 

الكود الذي سنعمل على إضافته إلى هذه الفورم هو تشكيلة عن الكود الذي كتيناه سابقاً في هذا الفصل.وسيعمل الكود الذي يبدأ كل تقرير سيمرر لهذه الفورم اسم ملف التقرير 
NRC‏ واسم تخطيط البيانات المستخدم والبيانات الفعلية.بما أن هذه التقارير ستكون غير "نموذجية 5ك#امله" "(أي تستطبع الحفاظ عليها مفتوحة بينما ما يزال بإمكانك 


استخدام الأجزاء الأخرى من برنامج المكتبة).لانستطيع السماح للكود المستدعي الانتظار حتى يعمل المستخدم على إغلاق التقرير قبل أن نطرح بيانات التقرير.سنسمح للتقرير 
التخلص من البيانات نفسها.لعمل هذاءنحتاج إلى الحفاظ على مرجع إلى هذه البيانات.أضف العبارة التالية إلى فة lلفورم .ReportBuiltiViewer‏ 
Private StoreDataTable As Object‏ 
تذكر أن بإمكان التقرير استخدام تشكيلة من تنسيقات مور د البيانات»متضمنة اتصالات قاعدة البيانات. المصفوفاتء۷ه۲۴ه .والتجمعات ١5‏ ٥ااءماامء‏ .ستستخمم التقارير من 1 إلى 
4 الحالة ماab‏ ۲ System.Data. Data‏ وسيمرر التقرير الخامس تجمع قائمة شمولية ۸٥:اcعاامع‏ ءا ممم و.الوقت المفضل للتخلص من البیانات عندما یتم إغلاق 
التقرير.أضف معالج الحدث التالي إلى الفورم»والذي يؤكد على البيانات التي تدعم عمليات التخلص قبل استدعاء الطريقة #كممءا. 
EE va Eê SUS KePDOE EEN EAMVNewmeE EHormEe losing (Eyal Sender AS OS eel EVAN CES‏ 
System.Windows.Forms.FormClosingEventArgs) Handles Me.FormClosing‏ 
1 ا كا مم ا 
If (TypeOof StoreDataTable Is IDisposable) Then‏ 
CType (StoreDataTable, IDisposable) .Dispose ()‏ 
ENG TE‏ 
End Sub‏ 
الكود الذي يعمل على فتح عرض هذ الفورم يمرر في قيم التقرير الأساسية من خلال طريقة عامة مسماة هم٠ S2٣۲۸‏ .أضف كودها حالاً: 
EUBDIIE Su SEarEREDOEE (BVVUSl whi eNRePOEE AS SErIRG, BYVal wAIERDateas enema AS SELIMI, |‏ 
ByVal whichData As Object)‏ 
ل و و ا 0 ا ا ا ج و ا ا 
ABIES VSS EAN E‏ 
ES E N O O MA O O LOT 1‏ 
ADEA xxx‏ : 
SE NE EES (O. a ENN ENES SS EON N SEAN Es :‏ 
1 واتلى جب ان تطابق اطاط 
Dim customDataSource As New Microsoft. Reporting.WinForms.ReportDataSource‏ 
: ربا الارن اال ير رال انات 
ReportContent. LOocalReport. ReportEmbeddedResource = whichReport‏ 
customDataSource.Name = whichDataSchema‏ 
customDataSource.Value = whichData‏ 
ReportContent. LOcalRepOrt. DataSources. Add (customDataSource)‏ 


عرض التقرير 
StoreDataTable = whichData‏ 
Me. Show ()‏ 
ERS SUE‏ 


يخبر هذا الكود العارض لاستخدام أي من التقارير كمصدر مضمن»ومن تم إرفاق البيانات كمصدر بيانات مخصص. ا2٥٠1‏ في أسماء الخاصيات يشير إلى تقرير العميل ٣٤‏ اع 
محلي بدل تقریر "خادم5۵۲۷6۲ " والذي يشتغل ضمن سكول سرفر.عندما كنا نشفل التقارير من قبل كنا نرى أن نمط العرض الافتراضي كان نمط "ملئ كامل الشاشة بمحتوى 
الصفحة".شخصياً أفضل ر ؤية حدود تلك الصفحة المزيفة.لا تتضمن الاأداة w e‏ ء0۲۲۷1 مء 8| Micr0s0خاصية‏ تتيح لنا تفير العرض الافتر اضي.ولكن نستطيع ضيط نمط العرض 
الأولي من خلال الطرق على هذ الأداة.عندما أضفنا عارض تقرير إلى الفورم» عمل الفيجوال أستوديو أيضاً على إضافة العبارة التالية لمعالج حدث تحميل الفورم .108٩4‏ 
ReportContent. RefreshReport ()‏ 
أضف الكود التالي قبل هذه العبارة تماماً: 
"'انتاج وعرض التقرير 
ReportContent. SetDisplayMode (Microsoft. Reporting.WinForms.DisplayMode. PrintLayout)‏ 
ReportContent. ZoomMode = Microsoft. Reporting.WinForms. ZoomMMode. Percent‏ 


ReportContent. Zoo0omPercent = 100 


نسيت أنني منذ أمد عملت على إضافة الفورم ا۷ ٤٥١/0/۲56م۴6‏ التي تقود التقاريرءولكنها موجودة في المشروع.في حال أنك نسيت كيف تبدو»سينعش الشكل التالي ذاكرتك. 
عملنا سابقاً على إضافة دعم من أجل خمس تقارير مينية داخليأً(أو جاهزة) في كود هذه الفورم.نحتاج إلى إضافة كود غفلنا عنه سابقاًءإذا كنت تستخدم ملف تركيب تقرير ا۸×× 
لملئ قائمة التقرير»وعملت على توفير شرح من أجل كل تقرير في ا ×.تعرض كل مدخلة ذلك الشرح في النصف السفلي من نموذج اختيار التقر ير٥6/‏ ۴800/۲86 .ولكن إذا 
كنت لاتستخدم ملف التركيب» وتعتمد فقط على الفورم لإضافة التقارير الخمسة الجاهزة بشكل افتراضي(التي عملتها)ءفإن الفورم لن تعرض الشروحات المرافقةءلأننا نسينا 
إضافتها.أضف دالة إلى الفنة ءءاء۲۲5هم٠R‏ والتي تعود بوصف قصير لكل من التقارير الخمسة. 
Private Function GetBuiltinReportDescription (ByVal whichReport As ReportlItemEnum) As String‏ 
1 العودة بالشرى انحرف مانا من أجل امتقاربر الاهزة 
Select Case whichReport‏ 
Case ReportItemEnum. BuiltInCheckedOut‏ 
RS LR‏ م الى الرة جى تر اة 
Case ReportItemEnum. BuiltInOverdue‏ 
NEE IN o AON CTS SE OT E‏ 
Case ReportItemEnum. BuiltInMissing‏ 
EEE n a all ONY yo CN‏ 
Case ReportItemEnum. BuiltInFinesOwed‏ 
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سنعمل على استدعاء هذا الكود من مكانين. الأول في الطريقة ماه 0۲۲6م20۸6٠1ا.يعمل‏ هذا الكود على تحميل في ملف تركيب تقرير ا[×.إذا كان ذلك الملف يتضمن واحد من 
التقارير الجاهزة.ولكن لايزود وصف معه» سنعمل على تزويد الوصف بأنفسنا.في منتصف دلك الكود تقريياً ستجد هذه الأسطر. 


وللأسفل بحوالي خمس أسطر ستجد العبارة التالية: 
أضف الكود التالي بعد تلك العبارة تماماً: 


Ype (CINE 


Then 


الحاجة الثانية من أجل الشرح الجاهز يظهر في الطريقة ءا اهمه s۸RمRefr.تعمل‏ هذه الطريقة استدعاء إلى مه 6مم 4R‏ هم الاستخراج تركيب ا ×. ولكن إذا بقيت 
قائمة التقرير بعد ذلك فارغةءتضيف اكءاا مم۸6 ۸ءRefreفي‏ التقارير الخمس الافتراضية كل شرح مطلوب.قرب نهاية الطريقةضمن الحلقة ×۴۲...۸6١٠۴.ستجد‏ عيارة الإغلاق 


التالية: 


هذا كل شيء بخصوص وصف التقارير»والآن ارجع إلى كتابة التقارير الحقيقية. الكود الذي يعمل على بدء تشفيل كل من التقارير الخمسة موجود سابقاً في الفورم 
ReportSelectومعالج‏ حدثھا ickاActRun_C.معظم‏ الكود المضمن في العبارة ٥458‏ اء٠ام5‏ والتي تعمل كلوحة تحكم من أجل التقرير المختار.إليك الجزء الذي يستدعي 
التقارير الخمس الجاهزة. 


أضف الكود التالي قبل تلك العبارة. 


من الواضحءأن هذا الكود لا يعمل الكثير.بدل كل من الأسطر "للعمل ".أزل الجزء"للعمل:اكتب" من العيارة.بحيث»ييدو مثلاً في السطر الذي يقول: 


غير الكود إلى : 
BasicReportCheckedOut ()‏ 
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أعمل ذلك لكل من الأسطر الباقية وذلك بإزالة التعليق عنها.‎ 
لعرض هذ الطرق الخمسة يتوجب علينا كتابة هذه الطرق.ستعمل هذه الطرق على استخلاص البيانات من التقرير»وترسل البيانات إلى عارض التقرير»على طول مع اسم الملف‎ 
.BasicReportCheckedOut ةقıرطJlب قصير جدأ وبسيطةءلنعمل على إضافة هذه الطرق بالترتيب إلى الفئة †ءهام ۲۲5م مء # التي نحن بصددھا الان.لنبد أو‎ يهو.Rا٤‎ 
Private Sub BasicReportCheckedOut () 
ا ا ا ا د ا ا‎ 
Dim sqllext AS SEEING 
Dim reportData As Data.DataTable 
Dim reportForm As ReportBuiltinViewer 
Om EEO COlLG BEEOEHSMAMe E 
SLT EES SY LT N 3 
sqlText = "SELECT PA.LastName + ', ' + PA.FirstName AS PatronName, " & "PA.Barcode AS 
EaEr ORNBA EOE, SE 
BE. DueDate, TC cCopyNumDer, TE. Barcode AS IEemeareOode, ES 
NT Tele, CMI EuNIName AS Medi aName CS CEI 
ARO EEO AS ES FC | 
ONNER ONN Ea er ONEOSY AS EC ON EAL SS ECEAETON CE 
INNER ON TEencopy AS TE ON EC TeEemcopy MM ES 
INNER OIN NamedlEem AS NI ON TE TEemID NID eS 
INNER YOUN CodeMedlalype AS CAN ON NT Medi aNVEBS SS MDCT 
"WHERE PC.Returned = 0 " & 
"AND PE.MISSInG OTE 
AND TEC Muses ing > OC 
"ORDER BY NI.TICle, TC. COopvyNumber, BPA.TastName, EFA. EIrSCName Ll 
reportData = CreateDataTable (sqlText) 
ET oS احخنار دع‎ 1 
If (reportData.Rows.Count = 0) Then 
reportData.Dispose () 
MSGJEOX SSN SoS Olo, MSOBOXSEVLe OKONLY OE MSIBOXSEVle ExClamalEi on, EEOSEAM Ele) 
Return 
End Tf 
E O SE EEE ETT 
reportForm = New ReportBuiltinViewer 
FEED SE ERGE SES EEREPOE E BEALE VY REDO EERE E EEOC E CALE, EBES VI REDOE ESEREMIES EE SR IECMS 
reportData) 
Ree WET 
ErrorHandler: 
GeneralError ("ReportSelect.BasicReportCheckedOut", Err.GetException ()) 
Re E UE 
ERG Sub 


يعمل الكود على استخراج سجلات خاصة بالتقرير من قاعدة البيانات»ويتأكد من أنه تم تضمين سجل على الأقل.(يمكن أن نكون قد أضفنا عبارة سكول إلى قاعدة بيانات المكتبة إما 
كإجراء مخزن ۲٥‏ ل۵۵ع ١١م‏ ك٠١هاء‏ أو عرض۷۴۷ .ونستدعيه بدل ذلك.من أجل أهداف هذا التدريب»كان من الأبسط تخزين العبارة مباشرة في الكود).ومن تم يعمل على 
استدعاء عارض التقریر»ممرراً له اسم ملف ٧٨801٤٥‏ واسم التخطيط(في التنسیق "512۳ھ N2 "6_٤!‏ 1ءەزه۴)»وجدول البیانات. 

التاليءأضف الطرق BasicRepor Overdue‏ و BasicReportMissing‏ .لن أعمل على إظهار الکود هناءبما آنه مشابه ما عدا اسم الملف 01٥‏ ۸والشرط ۷1٤۸٤‏ في 
عبارة سكول«وهي متطٰılقة .BasicReportCheckedOut J‏ 

وأضف الطريقة ٣٠5‏ 0۲۲۴م٠‏ ۸ء اه8 أيضاء والتي تعالج التقرير الجاهز الرابع . 
إنه مشابه تماماً للطريقة † 0 heke‏ C°BasicRepor.ولکنها‏ تستخدم عیارة سکول التي صممناها سابقاً من أجل استخراج غرامات زبون.ویستخدم أيضاً تخطیط مختلف واسم 
التقرير. 
وأخيرا أضف الطريقة sءناءناه†SمRe Basic‏ إلى الفئة 6 ٤ءء/٥8S٤/0مع۸‏ .والتي تعالج التقرير الجاهز الخامس.وهو مختلف قليلاً عن الأربع الباقية لأنه يجمع البيانات 
من جداول ست مختلفة» واحد واحد.في كل حالةء يستخرج إحصاء لعدد السجلات في جدول قاعدة البيانات.ومن ثم يتم تخزين النتائج في تجميع 

شمولي(†ءiا. Generic‏ .ectionsااSystem.Co).حيث‏ كل مدخلة قائمة هي حالة من ءعناءن†)2S n”‏ ءhءReportS.‏ الفئة المستخدمة من أجل تخطيط بيانات التقرير 
ااخامس.(راجع كود هذه الطريقة وتمعن النظر فبه). 

بما اننا نحتاج حقا إلى الحصول على نفس المعلومات((*)N1١C00)‏ من أجل كل من الجداول الست المضمنة. عملت فقط على تنفيذ الكود كحلقة.وعملت على بناء عبارة سكول من 
أجل كل واحد كما مررته من خلال الحلقة. 

تستطبع الآن تشغيل التطبيق وتستخدم التقارير الخمس الجاهزة.عليك الدخول كأمين مكتبة أو مدير »ومن ثم تمن من الوصول إلى لوحة "طباعة التقارير" على الفورم الرئيسية. 
تقربياً عند نهاية هذا الفصل سنكون تقربياً قد انتهينا من التطبيق.الشيء الكيير المتيقي والذي علينا عمله معالجة بنود زبون المستحقة الماضية لرؤية فيما إذا كانت الفرامات 
مطلوبة» سنعمل على إضافة هذا الكود في الفصل التاليء وستأخذ أيضاً نظرة عامة على الترخيص. 
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الفصل الثاني والعشرون:إجازة التطبيق. Mhm76‏ 
إجازة تطييaك Licensing Your Application‏ 

إجازة محتوى دوت نت المناسب يمكن أن يعني الاختلاف بين هيمنة السوق والإفلاس الماليءوما أحاول قوله فهم اتفاقية الترخيص التي تأتي مع الفيجوال أستوديو. سيبقى عليك 

استكشاف طرق الترخيص من أجل تطبيقاتك الخاصة قبل أن ترسلها إلى زبائنك.الترخيص و اتفاقيات الترخيص هي الوسائل الأساسية في حماية الملكية الفكرية التي عملت بجد 


sعnniمم‏ ")مع بعضهماءهذان الجذران يعنيان"قص الأكاذيب حول قطع صغيرة من النقود".أدى التشويش في محاولة فهم ما تعني هذه العيارة إلى بقاء الفتيان السيئين في حيرة 
exed‌امerمومشفولىن ed‏ iمuاءعەلوقت‏ طويل وكافي بحيث لا يسرقون تطبيقك. 

إذا لم تعمل هذه الطريقة.فتوجد حلول برمجية ءبعضها سأعيد عرضه في هذا الفصل.يركز قسم من المناقشة على تصميم نظام الترخيص الذي سيظهر في مشروع المكتبة.يعمل 
إطار عمل الدوت نت على تضمين فئات من أجل ترخيص المكونات ولکنها تستخدم بشکل رئيسي من أجل مصممات الأدوات المستخدمة بواسطة مبرمجين آخرين ضمن بيئة 
التطوير المتكاملة للفيجوال أستوديو 0۴| هالںS‏ اهنءا۷ .وليس من أجل تطبيقات المستخدم النهائية(أو إنهاء تطبيق المستخدم).لن نغطي ميز ات الترخيص هذه في هذا 
الفصل.إذا كان لديك الفضول لمعرفة مثل هذه الميز ات.ابدأً بقراءة "ما يخص متر جم الترخيص(۴×۴.٥/)‏ ١۵اأم‏ 0۳ع مءnءء‏ اا في المساعدة عير الشبكة للفيجوال أستوديو. 


بالعودة إلى الأيام الأولى للبرمجيات.فلم يكن الترخيص بالقضية:فإذا كان بإمكانك الدخول إلى الكمبيوتر»فهذا لأنك كنت مرخص(مفوض لك).جميع تفاعل المستخدم مع النظام كان يتم 
من خلال السرمضن واقتصاضي اة فاد ها أراد متك ها سر شىء مااف كو هة الشيء كاه خمل 26 طن من الو لن الأغلاك انيت الغرت آم الى فكل شىء 
سهل. 

ال ال م مخ الست كفن غر مهن اة وض حو غ آطاا دي كك كا الان اققا الرخض وى الان فعاة ل فاو ل ا 
الات الات الى ااا يكي دفي الف اعرا ناء ياتسات خزال وك ا العا اك اغ اله الك اف 
إلى التطبيق"؟كمية تحكم البرمجيات التي تضمنها ستقع في مكان ما ضمن الكمية المتسلسلة"حرية - أمن" كما هو مين في الشكل التالي. 


ريبما سئا 


إذا ما ذهبت إلى النهاية الحرة للطيف(مناسب بالنسبة للمستخدمين والهكر ز).فستكون على حالة عالية من الثقة بمستخدمي تطبيقك»وأية حمايات مدعمة تعمل على إرسالها بسرعة 
tchedمءiلإلى‏ مكاتبهم» لحفظ البرنامج في حالة امتتال(قابلية للتنفيذ بالنسبة لهم بحيث يستطيعون تجاوز هذه الحمايات).عند النهاية الآمنة من المسطرة المبينة في الشكل 
السابق("ضمانة بالنسية للمبرمجين وشركات المحاماة العالية الأجر ")تنفذ البرمجيات ممارسات وسياسات تضمن استخدام وحتى تنصيب التطبيق للمستخدمين المرخص لهم 
فقطءليس هناك حاجة إلى الحمايات المدعمةgUardsö armed‏ . 

باقي هذا المقطع يناقش بعض الخيار ات الممكنة التي تستطيع اختيارها ضمن المجال "حر - آمن". 


من الواضح أن الطريقة" اتفاقية التر خيص فقط" مفضلة بالنسبة للنمط الحر على الآمنءعندما تعمل على تزويد المستخدم بالبرنامجءيأتي مع اتفاقية تر خيص مصنوعة بحذر بحيث 
تنسق(تخطط) شر وط الاستخدام لكل من المستخدم ومز ودي البرنامج.بشكل عام تمنح المستخدم بعض الحقوق کالتنصیب»الاستخدام» ونشر البرنامج. عندما تكنب برنامج ليتم _ 
استخدامه من قبل منظمة معينة أو بواسطة مجموعة صغفيرة من المستخدمين والذين سيكون لديك اتصال نظامي معهم»يمكن أن تكون اتفاقية الترخيص فقط هي ما تحتاجه حقا.في 
الحقيقةءسأر اهن أن معظم تطبيقات الفيجوال بيسك في هذا الاتجاه.لقد أعلنت ميكروسوفت منذ أعوام أن الغالبية العظمى من مبرمجي الفيجوال بيسك يستهدفون في استخدام 
تطبيقاتهم منظمات عمل معينةمرتبطة بقاعدة بيانات خاصة معينة . تتطلب مثل هذه الأنظمة القليل جداً من طرق تشديد الترخيص,»بما أن التطبيق غير نافع عند إخراجه خارج البناء 
الذي كان القصد من التصميم.حتى ولو حققت برمجياتك انتشار واسعءفإن خطة الترخيص يمكن أن تبقى هي الطريقة.العديد من التطبيقات المفتوحة المصدر»من ضمنها أنظمة 
التشغيل الر نيسية والتي تتناغم مع "بلینکس "( ۸17/1 ./ p/w. £ org/ ice ^s |¬ 9/1: C ٥۸56/90‏ )تستخدم ترخیص عام وشامل للأساس البرمجي الحر ۴٣٥٤‏ 
S0ftWware Foundation‏ كسياسة رئيسية لانشر والترخیص. 


إذا كنت تريد القليل من التحكم على النشرءالتنصيب» واستخدام تطبيق ماءتستطيع فرض مفتاح الترخيص العام الناتج generated general /icense key‏ - بشکل أساسي 
كلمة المرور ١55۷0۲ص‏ التي تسمح بتنصيب التطبيق أو استخدامه.مثل هذه المفاتيح يتم إدخالها غالياً عند بداية تشغيل عملية التنصيب من قبل المستخدم حيث يتم الطلب من 
المستخدم مقتاح معين. بدون المفتاح لايمكن تنصيب التطببق. 


.إنتاج فقط رقم التسلسل التتابعي ۸١56۲‏ اهأ٣هء‏ اهنا٣مuوهء‏ .ومزج معرف المنتج ورقم الإصدار ضمنه.الشيء العظيم فيما يخص مثل هذه المفاتيح هي أنها سهلة التوليد.فلا 
نك واف التضرت عمل أك مط يكن فك على الاد جا عاج اله قط قمان أن التمن العام كه وال كد فاه لطي لت اك اما في اتا افاةة 
رةو طا أن أ وات هرف الو اكا اا هه ك كاه 

.استخدام المفتاح المتمازج أو المخلوطره) dعمااصهاءء or‏ إمطhas‏ .بالاعتماد على رقم تسلسلي ما أو صيغة يمكن أن يتم التحقق منها بواسطة برنامج التنصيب.يمكن أن 
تولد خوارزمية مصنوعة بشكل جيد مجال عريض من المفاتيحولكن تجعل من الصعب بالنسبة لآخرين لايعلمون الصيغة إنتاج مفاتيح مزورة خاصة بهم.على الرغم من أنني غير 
وط غل او لات فك موت لا و ف6 الاه ي كن الت ال رة ات افا مى أل ات الات دات ال25 ك تاي خم ك ال هه 
الفيجوال أستوديو. على الرغم من أنه صعب تلفيق المفاتيح بدون أساس واقعي أو حقيقي.فالطبيعة العامة للمفاتيح تجعلها عرضة للمشاركة.من أجل بعض برمجياتهاءتضم 

ميكر وسوفت مفتاح السيدي مع عملية التسجيل المعتمدة على الهاتف أو عبر الشبكة لتحسين الاأمن. 
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الق اى واوو ا ایق Mhm76‏ 
.تزويد مفاتبج متمازجة أو مشفرة or enعارما#١ k۷‏ dإمashم‏ بالاعتماد على رقم التسلسل الذي يتم تزويده(بشكل سري) مع برنامج التنصيب أو وسيلة النشر.عندما يعمل 
المستخدم على إدخال المقتاحءيتم فك التشفير أو يتم تحضيرهءومن ثم يتم مقارنته مع رقم التسلسل.إذا وفقط إذا تطابقا سيتم إتمام تنصيب اليرنامج بشكل مناسب. 


مفتاح الترخيص المنتج المخصص مشابه للمفتاح المنتج العام»ولكنه يستخدم معلومات شخصية يتم تزويدها من قبل المستخدم كجزء من عملية التوليد.مثل هذه المفاتيح أكثر تفاعلية 
.وتتطلب اتصال المستخدم النهاني بشكل خاص مع بانع البرنامج(أو التطبيق على موقع الويب) لإكمال عملية التنصيب.خلال عملية الشراء أو التنصيب»يقوم المستخدم بجعل 
معلومات معينة (مثل اسم المالك وتاريخ الشراء)متاحة لبائع البرنامج.ومن ثم یستخدم البائع تشفیر عام لمفتاح خاص key e۸٤۷ ما|٥ ١‏ rivateم-icاubم‏ (التشفیر غير المتماتل 
cryptography‏ ticمصصرasy)إما‏ لتشفير كامل أو لتوقيع رقمي للمعلومات ذات الصلة.يتم إعادة التوقيع المشفر فيما بعد للمستخدم النهائي من أجل التنصيب.تستخدم عملية 
التنصيب الحصة العامة من زوج المفتاح لضمان أن ذلك التوقيع صحبح.سنستخدم طريقة مفتاح الترخيص هذه في مشروع المكنبة. 


من أجل باتغي البرمضات الكقيري ان9 36١2م‏ :أو أولنك الف لذيم أسباب منطقة لظ الزمام مك على قاغة التتصيب الخاصة به توجذ لول قتضمن الوصول 
النطافي (أي. الا رخو دنات مفو )أو الحهات اة الد تام المح ها فرعي وضكة و امن الط اكاك مف الو فاوووة رجا مد ا 
البرامج من النسخهاو”هك )بشكل نموذجي جهاز #ء۷عل d١عءهط-اامم‏ معتمد على منفذ يو إس بي S8لابحيث‏ أنه يجب على البرنامج الوصول إليه كل مرة يتم تشغيله.يوفر 
A e aE Ee E SE e a AE e e E N IL‏ ا اا كا ال 
الوقت الحقيقي عبر الشيكة.كل مرة بيدأ البرنامجءمن الممكن أن يتمكن من الوصول إلى موقع بائع معروف ليشارك في عملية التحقق من الاستخدام.مثل هذه الأنظمة تتبح مر اقبة 
متواصلة للبرنامج من قبل البائعين والذي ومن المحتمل أن تكون لديهم أسبابهم العملية أو الحكومية لتحديد استخدام البرنامج. 

من أجل واحد من مشاريع زبوني»يجب علي أن أتمكن من الوصول إلى موقع ويب مشارك آخر بشكل شهري وأحول بيانات خاصة لاستخدامها مع برمجيات ذلك البائعيطلب ذلك 
اناع أن كن من الوضول اتا إلى جوككة من كما رخاف ك غدوان كول اتر نف مهن ۲658ل 1ة ۱۴ :وسوفن زو الماتات ذا ما خاولد الانصال من اك خهاز خر 
اها اكت كا سان غوان ات تت خو( كلى سل الفقال ها قوت ود كه ان على أن اعم وة كل الاق رة وان الات الك ن 
عة ووت ااقكنع وى انات اه در ها تون فم وة وش أن لد عمل تاع إلى خيكة لك الاكةا 6١‏ وكةو :عا أن روني كاد الفا ات ت 
لدي خيار إلا أن أزعن لاجراء التحقق الشهري. 


ار الغ مى الأنى نطاب ع فة رة ةط الك ف لفقل نضا ومخود مت مقرل ا كن آنل اى ال ات مها اة 
لعدد محدد فقط من الزبائن»ومن ثم على أساس عقد فقط وكجزء من اتفاقية العقديوافق الزبون أن يكون لديه عضو في الجهاز الإداري مدرب في يبع البرمجيات على الموقعء يشغل 
ويعمل صيانة على التطبيق من أجل الزبون.على الأقل سيطلب البانع أن يكون واحد من موظفيه متاح بشكل مباشر للزبون متى تم استخدام التطبيق. في عالم التطبيقات الغير 
مصنوعة من أجل الييع(للطلب).فييدو من المفرط #اطة"0اعءم هع" ناأن يكون مثل هذا النظام متواجد .ولكن في حالات الخطر العاليةء اهتمامات الأمن تطفو لهذا المستوى بحيث 
لا يتجرأً أي فريق أن يتلبس بالكامل مخاطر تنصيب واستخدام تطبيق هو ملك للغير. 

على الرغم من أنني أحث على استخدام هذا النظام من أجل مشروع المكتبة»ولكن أظن أننا سنيقى على التخطيط الأصلي في توظيف مفتاح تر خيص مولد مخصص-" 50ا٥‏ 

.generated license key 


كثيراً ما ترى اتفاقية الترخيص تظهر قبل إتمام تثبيت بر نامج ما.تخبر اتفاقية الترخيص المستخدم" اذهب للأمام»ونصب واستخدم البرنامجءولكن عليك إتباع القوانين التالية."على 
الرغم من أنه يتم كتابتها غالباً بشكل قانونيءيمكن أن تظهر في اللغة الحقيقيةءمثل الإنكليزية.وهي تختلف في مجال الحقوق الممنوحةءمن "تستطبع استخدام هذا البرنامج»ولكن عندما 
تنتهي»يجب عليك تدمير جمبع النسخ"إلى"استخدمه»وأنت حر في تمرير نسخة من اليرنامج وكوده المصدري لأصدقائك وأقربائك."يأتي برنامج المكنبة الموفر مع هذا الكناب مع 
اتفاقية الترخيص. 

إن أي برنامج تعمل على صياغته ضمن إطار العمل لأن يتم استخدامه خارج شركتك الخاصة يجب أن يتضمن نوعاً ما من الاتفاقية بينك(شركنك)وبين مستخدم | لبرنامج.يمكن لهذم 
الاتفاقية أن يتم تحديدها كجزء من العقد الذي يعمل على تأسيس مشروع تطوير البرنامج(وهذا نموذجي بالنسبة لمستشاري البرنامج)أو يمكن أن تعمل على تضمين الاتفاقية كمكون 
من البرنامج(شائع الاستخدام من أجل البرامج الفير موضوعة تحت الطلبogramsٽp off-the-shelf‏ (. 

مهما تكن الطريقة التي تختارهاءمن الهام أن تذكرها بالشكل المكتوب.لاأنها يمكن أن تجنبك الندامة في المستقبل.توجد اتفاقية الترخيص عادة لحماية حقوق بائع البرمجيات»ولكنها 
ستكون عديمة الفائدة إذا لم تمنح حقوق ذات أهمية للمستخدم-بعض الحقوق يمكن أن تكون كريمة جداً. 


لقد لمحت على نحو قليل حول ميزات التشويش الموجودة في الفيجوال بيسك2008 في الفصل1 و5.ولكن حان الوقت لنلقي نظرة فعلية على هذه الميزات.تتضمن الفيجوال أستوديو 
إصدار ذو عری(تبوییات)من ۲٥2عءں؟اه0تابع‏ لشركة اسمها ۷۵ام "۴۲۵۴ (ليست جزء من ميكروسوفت حتى الآن).لامكانية الوصول إلى البرنامجء استخدم القائمة أدوات 
0tfuscator Community Edition < < Tools‏ في الفيجوال أستوديو.تظهر الواجهة الرئيسية كما هو مبين في الشكل التالي. 
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| setup | options | Ip Rename | control Flow | String Encryption | Removal | Linking | Premark | Bula Î Cutput | 


Input Assemblies: 


B5 goa x 


حتى ولو كانت هذه النسخة الأساسية من المنتجءفإنك ترى أن لديها خيارات كثيرة١0ااأ#هو‏ .إذا كنت تريد الفوص إلى ميزات المحسنة من أجل مشروعك.فإن هذا غير 
ممكن.فساغطي فقط الا ستخدام الاساسي لها هنا. 
دعنا نستذكر بشكل سريع لما تر يد تشويش 06/٠/5٥410‏ كودك. أو حتى استخدام كلمة تشويش 40ء ءا/06٥في‏ شركة مختلطة.إليك بعض الكود من مشروع المكتية: 
Public Function CenterText (ByVal origText As String, ByVal textWidth As Integer) As String‏ 
Center a piece of text in a field width.‏ صصص ٣‏ 
I TE Ehe EERE 1S EOS WEIS, EEUNCAES DE.‏ 
Dim resultText As String‏ 
resultText = Trim(origText)‏ 
If (Len (resultText) >= textWidth) Then‏ 
ea Truncate as needed.‏ 
Return Trim (Left (origText, textWidth) )‏ 
Else‏ 
Start with extra spaces.‏ حص ٣‏ 
RE EUrT Space (EOS EMIOAEN  UWen(OriGle<E)) KC 2) € EeSUIECLOXE‏ 
ERS UE‏ 
Ena EUnNECE N OM‏ 
هذا الكود سهل الفهم تماما وخاصة مع التعليقات وأسماء الطرق والمتفيرات المعبرة.على الرغم من أن تشويش الدوت نت يعمل على مستوى لفة ميكر وسوفت الوسيطةءدعنا 
نتظاهر أن ذلك المشوش يعمل مباشرة في كود الفيجوال بيسك.فتشويش هذا الكود يمكن أن يعمل على إنتاج نتيجة مشابهة للتالي: 
Public Function A(ByVal AA As String, ByVal AAA As Integer) As String‏ 
Dim AAAA As String‏ 
AAAA = Trim (AA)‏ 
IF (Len (AAAA) >= AAA) Then‏ 
Return Trim (Left (AA, AAA) )‏ 
Else‏ 
Return Space ((AAA - Len(AA)) \ 2) & AAAA‏ 
ERG Tf‏ 
End EURGEIOR‏ 


في مثل هذا الروتين البسيط ما يزال بإمكاننا استكشاف(فهم) المنطق»ولكن مع جهد أكبر لما في النسخة الأصلية أعلى هذا الكود.بشكل طبيعي التشويش الحقيقي يذهب أبعد من هذاء 
مازجاً إمكانية القراءة للكود على مستوى اللفة الوسيطةمحيرة و”اف”نه؟”هعقارني الكود والهكرز على حد سواء#>ناد 00 5000 

1.ابني مشروعك في الفيجوال أستوديو باستخدام قائمة .Build [Project Name] [عaرشمll| مسا]eliڊ< < Bui|d cli‏ 

2.شفل ٣٥ا0tfusca(باستخدام‏ قائمة أدوات ءاھ > < Community Edition‏ 0tfuscatorطD‏ في الفیجوال استودیو. 

3.عند السؤال عن نوع المشروع اختر»إنشاء مشروع جدیداecزە Create New Pr‏ .وانقر الزر موافق0۸ . 

4.علی تبويب "إدخال اام |٣‏ "لنافذة تطبيق0۲هءءںfاه0‏ .انقر الزر "استعراض وإضافة مجمع للقائمةاءاا Browse and add assembاy ٥‏ ".وھو الزر علی شریط 
الأدوات في الزاوية اليسارية والذي بيدو ذو أيقونة مشابهة لمجلد ملفات مع سهم صغير في أعلاه-على اللوحة المبينة في الشكل السابق. 

5.عند السؤال عند ملف المجمعهاا؟ راا" #ءءه .استعرض من أجل تطبيقك المتر جم وانقر الزر موافق ©0 .والمجمع الذي سيستخدم سيكون في الدليل الفرعي 
Re/e2se/ام/‏ ضمن دليل الكود المصدري لمشروعك. 

6.اختر القائمة ملف ٠ا۴‏ > >بناء هاا8uلنتاج‏ المجمع المبھررا ٥ءء obfuscated‏ .سیتم سؤالك لحفظ ملف مشروع ١٥اھےcءں؟†ه‏ 0 (ملف ا )قبل أن تبدا عملية 
البناء.احفظ هذا الملف إلى دليل جديدرإاهاء ماك "٥W‏ .عندما يحدث اليناء.فسيتم حفظ المجمع الناتج راطا"٣عءكه‏ اماه في الدليل الفرعي في نفس الدليل الذي يحتوي على 
ملف مشروع اM×.‏ 

7.اكتمل البناء» ويظهر ملخص كما هو مبين في الشكل التالي.إن الملف الميهم جاهز للاستخدام.تعمل هذه العملية أيضاً على إنتاج ملف ١/۴‏ ×.م2/ والذي يوثق تغفيرات جمبع 
الأسماء المعمولة للأنواع والأعضاء ضمن تطبيقك.وسيكون شيء سيء نشر هذا الملف مع المجمع.فهو من أجل أن تستخدمه أنت في تصحيحك فقط 
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WlDotfuscator Community Edition 


Build Statistics: 


Renamed Percent Renamed 


Types: 100,00 e 
Methods: 73D 
Fields: 100.00 


Messages: 


Doatfuscator Community Edition cannot rename generic types or methods, 
IF ¥ou would like Dotfuscator to rename generics, please try Professional 
Edition, See www ,preemptive,com for more details. 


tommunity Edition cannot rename generic method Create__Instance__ 
[!!O(H!0}] in class WwindowsAapplication1 .My.MyProjectMyForms. 

rommunity Edition cannot rename generic method Dispose_ Instance 
[voidf!!08] in class WindowsApplication 1, ly. MyProjectfMyForrns, ا‎ 
Community Edition cannot rename generic method Create__Instance__ 
[!!O(H!0}] in class WindowsApplication1 1y. ™MyProject}™ywebSerwices, 
Lommunity Edition cannot rename generic method Dispose__Instarite__ 
[vaid{!!08}T in class WindowsApplication 1. My. MyProjectMyWebServices, 
Community Edition cannot rename generic class 

WindowsApplication 1. My.MyProject{ThreadSafeObjertProvider’ 1, 


لبرهان أن التشويش قد حدث. استخدم أداة مفكك اللغة الوسيطة ١اط"‏ #ءءهءا إااوالتي تأتي مع الفيجوال أستوديو لتفحص كل مجمع.(على نظاميءيمكن الوصول لهذا 
البرنامج بواسطة قائمة ابدأ S2٣‏ < < جمبع لير lمmszn jı Disassembler < < Tools Glgsİ< < Microsoft Windows SDK v6.O0A< < [AII] Progra‏ 


الشكل التالي المتغيرات العامة المضمنة في ملف لمشروع المكتبة قبل الإبهاء: 


uments and Setingsimh. ت‎ 


F MANIFEST 
2 wirdomsigplkcstiont 
2 irdoregipglcstionl. Mir 
#  Wrdowzhpglcationl. Hir Rerources 
* BE Wir dowshpglcstionl. Mir -Intermsbimiielger 
i BE Wirdosipglcstionl. Mr Myhgglkcetion 
# E Wrdeshpgllcstionl. My MirSomouter 
#* E Wrdowshplcstienl My Myfvoject 
FE Wirdousipglestienl Mr My Setting 
# E Wirdousipglcstenl My MySetingErtperty 
E E Wircdresipgkcsticel Fort 
F deê pijbke Sit rêl bêfêrefiêlanik 
FF Gite [Spt WIRE Fria] pite. WRsHivaê. Ft 
FF etê RARE wil [NiCr OSG. Mn salatie Mir osûft. 
© _Bitinl : private dast [Syste Wind Formê rete g 
@ ENR i private stake dass [mecorlk îye. Collect 
@ tameinerks : private dats [Sytea jy stem. Cangonartk 
sêta 3 wok 
tur : vokÛ 
I i: arg tring, tiz) 
I iton1 Chk i voldfsbject, dass [mecerlb jS rite. Evert! 
I Carteret : ring string, tî) 
I Ctegose : vakdlboel) 
I Firaı _Losd : vokkiibiect, class [mscurlb yarem, Evert 
IntiskzeCorpurrent : vod 
get_Buttont lass [rte WKH Forint Sir Sbefi. WI 
I se_ ton : vokkidlass [Brite Winns, Farts ]Sysken 
dh tonî i tance dass [Sytem Windom Forms jire 


avrmbhy Wirdrmipgk aha 


ver 10:0:0 


.النسخة المبهمة لهذة المتغيرات يظهر الشكل التالي. 


C:Documents and Settingsimh... 
File view Help 


F# .custam instance woid [mscorlib]System.Runtime, Compiler Ser 
Þ .custom instance void [mscorlib]system Diagnostics, Debugge 
El ai class c0 
A Ec 
أ‎ .class private auto ansi sealed beforefieldinit 
extends [System] ystem. Configuration, Application Settings 
custom instance void [System System. CodeDom.Campiler .Gı 
,custam instance void [msrarlb]system Runtime, Compiler Ser 
ıcuskom instance void [System]5ystem,ComponentModel, Edit 
® a: private static class c 
@ bı: private static bool 


E .cctor : voidt) 

I ctor : void) 

El a: class c0 

El a: void(object, class [mscorlib]System, EventArgs) 


A Ed 


ıclass private auto ansi sealed 
„custom instance void [System]5ystem,CodeDom,Compiler,Gı| 
custom instance void [Microsoft .MisualBasic]Microsoft, Visualt 
„custom instance void [Microsoft,visualBasic]Microsaft, visualê 
,cuskom instance void [mscorlb]5ystem. Diagnostics. Debugge| 
custom instance void [mscorlb]System Runtime. Compiler Ser 
@ a: private static class [mscorlib]System Resources, Resource! 
ıcuskom instance void [Microsoft VisualBasic]Microsoft, WisualEasic 
El a: class [mscorlb]System.Globalization.CultursInf af 
El a : vaid(zlass [mscorlb]system, Glabalizatian,Culture1rfo) 
! class [mscorlb]5ystem.Resources, ResourceManager (j 


4 1 ٠ 


assembly WindowsApplication 1 


„ver 10:0:0 


لن أعمل على إجراء تشويش على مشروع المكتبة من خلال مقطع التدريب هذا.وأنت حر في تجرييها فيما يخصك. 


الأدوات التي سنستخدمها لتصميم نظام ترخيص مشروع المكتية يمكن أن يتم بناءه من ١١٣×.م12‏ وهو ملفا" ×. وتم مناقشته في الفصول السابقة: 
.يحتوي ملف الترخيص محتوى ا ×.الفصل 13. 

.يظهر الترخيص كملف منفصل في نفس المجمع ه×ع.ر/2٣0/.يقرأً‏ برنامج المكتبة المحتوى من ملف الترخيص.(الفصل15). 

.سيتضمن التر خيص توقيع رقمي ۲6ا۸2 9اك اهاأواك .معتمد على تشفير عام لمفتاجح خ|اص^ڊټencryptio public-private key‏ .الفصل11. 


الفصل الثاني والعشرون:إجازة التطبيق. Mhm76‏ 
كلما تم تشفيل تطبيق المكنبةءيحاول قر اءة ملف الترخيص.إذا كان الملف غير موجود.أو إذا كان يحتوي بيانات غير صحيحة أو توقيع غير صحيحءينحدر اليرنامج إلى الميزات 
الأدنى المتاحة.معطلاً تلك الميزات يتم اعتبارها مرخصة. 


يحتوي ملف ترخيص مشر وع المكنبة بعض الملكية الخاصة الأساسية ومعلومات الحقوق المتعلقة بالمستخدم الذي اشترى الحقوق ذات الصلة بالبرنامج.إليك محتوى ا ×الذي 
جئت به: 
CAML version OF ERNCOALRGE UE E Oa‏ 
<License>‏ 
<Product>Library Project</Product>‏ 
TA CenSeDa Ee >l 11 72U00 TA CER SED E>‏ 
<ExpireDate>12/31/2999</ExpireDate>‏ 
<COVNEEE AMEE SIOR > I 3< A CSVET EAMEES ION >‏ 
<licensee>John O0. Bublic</Licensee>‏ 
<SerialNumber>LIB-123456789</SerialNumber>‏ 
</License>‏ 


يبدو أن هذا كافي.العملية التي تبني التوقبع الرقمي ١١‏ اه٠‏ واء اهاأوال تخزن أيضاً توقيع مشفر ضمن محتوى ا١×.‏ 


في مقطع المشروع لهذا الفصل سنعمل على بناء تطبيق جديد يتواجد بشكل وحيد لتوليد ملفات الترخيص من أجل تطبيق المكنبة سيكون له ثلاث مكونات رئيسية: 

.إنتاج وإدارة المفاتيح العامة والخاصة المستخدمة في معالجة التوقيع. 

2.الطلب من المستخدم تاربخ الترخيص6 ه2ل ه5٠ءء|ا‏ تاريخ الانتهاء(انتهاء الصلاحيةءاةك ”هااجاiام×ء‏ ).الإصدار المفطى"0اءve۲ covered‏ .اسم المرخص له 
ameہ‏ icenseeا.والرقم‏ المتسلسل #۲ط"”ن" اهاهء من أجل ترخيص وحيد. وهي القيم التي تظهر في محتوى ا ×لملف الترخيص. 

3.إنتاج ملف الترخيص ا ×والتوقيع الرقمي 9اك ۷|اهااواك الذي يستخمدم المفتاح |llخlاصkey private‏ . 


سيبين لك مقطع المشروع لهذا الفصل كيف يتم إنتاج ملف تر خيص شمولي 56١۴ءا‏ عأه هل .وهو ملف ا۷×سيتم نشره وتنصيبه مع تطبيق المكتبة باستخدام برنامج 
التنصيب الذي سنبنيه في الفصل 25. وسيتم تسمية الملف ١ا ۲/1/٥٥٠5.‏ 6/2/(بشكل افتر اضي)وسيظهر دائماً في نفس الدليل L/۲4۷. ٠×6‏ لملف التطبيق . 

إذا كنت اعمل على تطوير تطبيق حقيقي من أجل بيعه لازبائنءولدي موقع ويب»والذي يدعم خدمات ويب(التي سأتحدث عنها في الفصل23)ءإليك واحد من التصاميم لتنصيب ملف 
الترخيص الذي يمكن أن استخدمه: 

2.أثتاء التنصيب»يطلب بر نامج التنصيب من المستخدم تفاصيل الترخيص التي تظهر بشكل نهائي في ملف ترخيص ا××. 

3.برنامج الاإعداد يتصل بخدمة ويب على موقع الويب للبائعءويمرر القيم الموفرة من قبل المستخدم لخدمة التسجيل . 

4.تعمل خدمة الترخيص ١ء‏ ء ۲۷ء 0۸ا a١†isوماعلى‏ إعادة ملف ا۷N×موقع‏ بشكل رقمي يحتوي على محتوی الترخيص. 

5.برنامج الاعداد ۲2۳وه۲م مناهء ينصب هذا الملف على طول مع التطبيق. 

6.إذا لم يكتمل الترخيص بنجاح لاي سبب كان خلال الإعدادفإن التطبيق الرئيسي يحتوي كود ترخيص 0٥١0ء‏ و” ك١‏ معا مشابه»ويمكن أن يتصل مع خدمة التسجيل 
registration service‏ iفlw.‏ 


كلما تم تشغيل تطبيق المكنبة.فإنه يقرأ ملف الترخيص ا ×وينجز العديد من الاختبارات لضمان أن الترخيص متاح من أجل تنصيب التطبيق الحالي.إذا كان الترخيص غير 
صحبح لأي سبب كان»يمكن لمقاطع التطبيق الوصول إلى الميزات الإدارية المحسنة المضمنة في نظام المكتبة. 


في كود مشروع هذا الفصل»سنتيع اثنين من أريع خطوات تم مناقشتها سابقاً في هذا الفصل في المقطع "نظام ترخيص المكتبة". و المقطع :إنتاج واستخدام ملف التر خيص. والتصميم 
الذي عملنا على إنشائه سابقاً كافي وجيد بحيث يلبي حاجاتناءعلى الرغم من أننا ما نزال بحاجة إلى تسجيله في التوثيق التقني للمشر وع.لن نعمل على تنصيب ملف الترخيص 
رسمياً حتى نعمل على إنشاء برنامج التنصيب في الفصل25. 


بما أننا سنعمل على إضافة ملف خارجي جديد وسيتم معالجته بواسطة مشر وع المكتبةءنحتاج إلى توثيق تر كييه في مجموعة الموارد التقنة للمشرgعg Technical ReSOUrCe‏ 
.تعمل على إضافة المقطع التالي إلى ذلك المستند. 


يقرأ مشروع المكتبة ملف ترخیص يتم تعينه من قبل زبون مولد بواسطة تطبیق دعم منشئ تر خيص |لمكتية Joa. Library License Generation support app|icati0‏ 
ذلك البرنامج على إنتاج ملف ترخيص ا ×موقع رقمياً يتضمن معلومات صاحب الترخيص(أو المرخص له).إليك عينة عن محتوى ملف الترخيص: 

Saxml version Tl QS 

<License> 

KEEOSUEE TNDEATY PEOMCCES 7 EOC 

<uicenseDate>1 /1/2000</LicenseDate> 

<ExpireDate>12/31/2999</ExpireDate> 

<CoveredVersion>1.*</CoveredVersion> 

<Licensee>John Q. Public</Licensee> 

<SerialNumber>LIB-123456789</SerialNumber> 


Mhm76 الفصل الثاني والعشرون:إجازة التطبيق.‎ 
<Signature> 
Digital signature appears here (not shown) 
</Signature> 
</License> 


تشير العلامات<هة#0ء١ءءا>‏ و<هاة20ءءiم×E>‏ أول وأخر تاريخ للتر خيص.وتشير العلامة <هه5٠٠٠ا>إلى‏ اسم صاحب التر خيص.وتتضمن العلامة 

<اNumbe Seri‏ >رقم التسلسل المحدد من قبل البائع والمرافق مع الترخيص. وتحتوي العلامة<١‏ اء ه۵۷٠۲٠۷٥٥>‏ بيانات مشابهة لرقم نسخة المجمع المضمن في تطبيقات 
الدوت نت.ولديها أربع أجزاء محددة رنãقطmajor>.<minor>.<build>.<revision>:ã<‏ . 

كل مكون يمكن أن يتضمن عدد من صفر0 إلى 9999 .أو رمز النجمة(*)ءوالذي يشير إلى جميع القيم الصحيحة من ذلك الموضع.يحتوي المقطع <هءںاة٠واS>التوقيع‏ الرقمي 
المولد.ويعتمد تنسيقه على أدوات تشفير ا ×في الدوت نت التي تولد ذلك المقطع.لضمان توقيع رقمي مناسب»استخدم دائماً تطبيق دعم منشئ ترخيص المكنبة لبناء ملفات 
الترخيص. 

يعمل تطبيق الدعم على إتتاج زوج مفتاح عام وخاص من أجل الاستخدام في التوقيع الرقمي. الجزء العام من المفتاح(كملف ا ×)يجب أن يتم إضافته كمورد مسمى 
icKeyاkicensePubاإلى‏ تطبيق المكتبة.ويجب أن بيقى الجزء الخاص خاص.من أجل الاستقرار»يجب أن يتم استخدام نفس زوج المفتاح على طول عمر مشروع المكتية المتوفر. 
سنعمل أيضاً على تخزين موضع ملف الترخيص كإعداد للتطبيق في الير نامج الرئيسي.نحتاج إلى تسجيل ذلك الإعداد مع إعدادات التطبيق الأخرى التي عملنا على إضافتها إلى 
مقطع إعدادات المستخدم لمجموعة |Jمlgرs «Resource Kit‏ 

LicenseFileLocation 


مسار ملف ترخيص المكتبة على محطة العمل هذة(أو الشبكة المحلية)إذا لم يتم توفيره سببحث البرنامج عن ملف مسموت//.0/2//1/0.۸56// في نفس مجلد التطبيق . 


سيكون إنتاج ملفات الترخيص والتواقيع الرقمية يدوياً باستخدام المفكرة سيكون... حسن.ولكننا لن نفكر بهذا.بالمقابلء سنعتمد على تطبيق خاص لانتاج الملفات والتواقيع الخاصة بنا 
عملت على إتتاج تلك الأداة الخاصة من أجلك.ستجدها في دليل تنصيب كود هذا الكتاب» في الدليل الجزئي ( ).يتضمن تطبيق الدعم هذا نموذجین 
رنيسين.الفورم الأول(۸67/£0641/07۶0/.۷6) المبين في الشكل التالي يحدد أو يعمل على إنشاء ملفات مفتاح عام-خاص ۷ه 8أ۲۷2م-ءناطاناميتم استخدامها في عمليات 
التوقيع الرقمي digital si9 ¬2 r‏ . 
ublic- Private Key for Library Distribution‏ 
License generation requires a valid public-private key pair to use for the digital signature, This‏ 


| For identifies the directory that contains the two key files, IF the directory contains no key files, 
| عع‎ the Generate Keys button to create thern, 


٤ Directory: 


BFOWSE,.., ا‎ Lonfirm 


mM Status text, 


٤ IF this directory does not contain a key pair, generate the Files using the Generate Keys button, 


aenerate Keys 


1 Ok أ‎ Cancel 1 


يساعد معظم كود هذه الفورم على إيجاد والتحقق من المجلد الذي يحتوي على ملفات المفتاحين(واحد خاص»واحد عام).بعض الكود في معالج حدث ^c1Ge nera e_Cا1 e)‏ يعمل 
على إنشاء الملفات الفعلية. 
E Generate and save the keys.‏ 
Dim twoPartKey As RSA‏ 
Dim currentStatus As KeyFolderStatus‏ 
Dim pul CEI AS SEEING‏ 
Dim privateFile As String‏ 
Generate the keys.‏ کت ٢‏ 
twoPartKey = New RSACryptoServiceProvider‏ 
twoPartKey = RSA.Create()‏ 
Save the public key.‏ چچچ 1 
My COMPU EA leSvS EEN WET Ee Kee (BUS LEE TE‏ 
twoPartKey.ToXmlString (False), False)‏ 
RefreshFolderStatus (KeyFolderStatus.MissingPrivateFile)‏ 
Save the private key.‏ 0 
Mv COMB uUiEer Ei leSvS eM. iE EEA MESE (OEE vA EOE 1e, ||‏ 
twoPartKey.ToXmlString (True), False)‏ 
RefreshFolderStatus (KeyFolderStatus.ValidFolder)‏ 


هذا بسيط جداً.فالفئة System «Security. Cryptography. RSA‏ وخ R SACryptoServiceProvider‏ لمر تبطة بها تقومان بجمبع العمل.كل ما عليك عمله استدعاء الطريقة 
RSA.Cre2te‏ ومن ثم إنتاج مفاتيجح ا1 ×ذات الصلة باستخدام الطريقة وا۲ 8١٣×٠٠ءممررآً‏ معامل نسبي (خطأهءاه۴ ) من أجل المفتاح العام هk‏ ااام ءوصواب عںu٣٦‏ 
من أجل المفتاح الخاص۷ه ۷8١م‏ .إذا كنت تريد الإطلاع على بعض عينات المفاتيح, افتح الدليل الجز ني (68758۶//68/).ستجد ملفين»واحد من أجل المفتاح العام والآخر 
من أجل المفتاح الخاص.سأعمل على طباعة واحد منهما هناءولكن سببدو كحروف عشوائية.الفورم الأخرى هي الفورم ۷6 .2/7۴0/7//»والتي تعمل على إنتاج ملف الترخيص 
النهائي الفعلي للمستخدم»وتظهر في الشكل التالي. 


* [fbrary License Generalion 
Public-Private Key 
Location: 
Na directory specified, 
License Generalion 
License Date! Saturday , December 20, 2008 


Expiration Date: Tuesday , December 31, 2939 


Lovered Yersion! E DZS, GF. 


Licensee Name: 


Serial Number: 


Generate 


كما مع الفورم الأولى.معظم الكود يضمن بيساطة أن ملفات المفتاح العام والخاص سليمة.وأن المستخدم قد أدخل بيانات صحيحة قبل الإنتاج. وأهم ما في هذه الفورم هو 


الز ر "إنتاج ٤إ‏ مnمG"‏ ومعالج حدثه iekاActGenerate_C‏ .أو نحتاج إلى بعض محتوى ×× .والذي نينيه بالطريقة† Build Xm | License 07 † e٢‏ .فهي تعمل على إنشاء 


المحتوى عنصر عنصرءباستخدام الطرق التي تحدثنا حولها في الفصل13.ءعلى سبيل المثالإليك جزء من الكود الذي يعمل على إضافة الرقم المتسلسل. 
Add the serial number.‏ 
dataElement = result.CreateElement ("Serial!‏ 
dataElement. InnerText = Trim (SerialNumber. Text)‏ 
rootElement. AppendChild (dataElement)‏ 
ومن تم يأتي التوقبع الرقميءبواسطة الدالة e٤‏ LicenseC|اSignXn.معظمها‏ یظهر ھنا: 

Function SignXmlLlLicenseContent (ByVal sourceXML As XmlDocument) As Boolean 
٣ Add a digital signature to an XML document. 
Dim privateKeyFile As String 
Dim privateKey As RSA 
Dim signature As SignedXmlL 
Dim referenceMethod As Reference 
ا‎ Load in the private key. 
privateKeyFile = My.Computer.FileSystem. CombinePath ( 

KeyLocation.Text, PrivateKeyFilename) 
TE My SCOMPUEEG. ALESIS: E = False) Then 

MsgBox ("Co 1 

MsgBoxStyle. OkOnly EOS Es RREeLamaêAoy ProgramTitle) 

Return False 
End TF 
privateKey = RSA.Create () 
privateKey.FromXmlString (My. Computer.FileSystem. ReadAl lText (privateKeyF ile) ) 
ص ا‎ Create the object that generates the signature. 
signature = New SignedXml (sourceXML) 
signature. SignedInfo.CanonicalizationMethod =SignedXml.XmlDsigCanonicalizationUrl 
signature. SigningKey = privateKey 
کے کے‎ The signature will appear as a <reference> element in the 
0 XML. The signature object can generate that automatically 
5 if we tell it to. It's more important later when trying to 
verity the signature. his CranSstOoOEmM says EO 1ngorEe the 
signature itself when comparing the signature. 
referenceMethod = New Reference ("") 
referenceMethod.AddTransform (New XmlDsigEnvelopedSignatureTransform (False) ) 
signature. AddReference (referenceMethod) 
ا‎ Add the signature to the XML content. 
signature. ComputeSignature () 
sourceXML. DocumentElement. AppendChild (signature. GetXml () ) 
کچھ ل‎ Finished. 
Be EER EUS 


Private 


BEEOrHandl er; 


MsgBox ( 1 0 1 € 2 چ‎ 
) & BCE E & TBCELÊ E EFE, DESEEASELOR, | 
Mee Sle. OKONIY OE MSGBOXSEVLe EXCEL amalEilon, EEOGEAM U E Le) 
Return False 
EUREEIOR 


يحدث التوقيع الرقمي بواسطة الفئة ١٣×له”وا؟(في‏ فضاء الأسماء ١١×.ر۸مraاوtoمpرCr.رstem.SecutرS).تستخدم‏ هذه الفئة طرق توقبع مختلفةءوالتي اخترتها 
sig anonicaliation Ur)‏ Xm)يتم‏ استخدامها من أجل ا ×نموذجي وتتجاهل التعليقات الموجودة. 


End 


الفصل الثاني والعشرون:إجازة التطبيق. Mhm76‏ 
يظهر هذا التوقيع كعلامات وقيم في مخرجات ۷1× المضافة من خلال العبارة ۴1١‏ ٠مم‏ قرب نهاية الدالة.بما أننا لا نريد أن يتم أخذ التوقيع نفسه بعين الاعتيار عندما 
نبحث فيما بعد عن ملف ا۷ ×من أجل المحتوى الصحيج» تضيف الفئة 4×١‏ هواك التوقيع كعلامة <هء١٠ءء؟هع>‏ .ويحدث هذا في الكود بإضافة كائن مرجعي عع٤١6إ6مR‏ 
زط والذي يتم برمجته من أجل تلك الاهداف. وتمت إضافته من خلال استدعاء الطريقة „signature. Add Reference‏ 
حالما يكون لدينا توقيع في محتوى 1× .نكتبه كمخرجات إلى ملف محدد من قبل المستخدم بواسطة الطريقة القياسية "٠۸٤.52۷6‏ uء00ا"×‏ في معالج الحدث 
.ActGenerate_Click‏ 
licenseXML. Save (LicenseSaveLocation.FileName)‏ 
إليك عينة ملف ترخيص1× والذي يتضمن توقبع رقمي.وهذا هو الذي عملت على تضمينه في الدليل 
<?xml version="1.0"?>‏ 
<License>‏ 
SBEOdAUGE LI BEAEV BEONECE VEEOAMGE >‏ 
<LicenseDate>1/1/2000</LicenseDate>‏ 
<ExpireDate>12/31/2999</ExpireDate>‏ 
<CoveredVersion>1l.*</CoveredVersion>‏ 
<Licensee>John Q. Public</Licensee>‏ 
<SerialNumber>LIB-123456789</SerialNumber>‏ 
Sina lUre XMIRNS TOL EP LNW MS. OEO 120 OO 1O mS GH‏ 
<SignedInfo>‏ 
<CanNOnI Cal izationMe EROS AISOEI ERM NEED AU. WS OLO IR/ 2001 REC xml C12 200O 1>‏ 
<SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-shal" />‏ 
<Reference URI="">‏ 
STEARNS OEMS >‏ 
<Transform Algorithm="http://www.w3.or9/2000/09/xmldsig#enveloped-signature" />‏ 
VME ARNSESEMS >‏ 
<DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#shal" />‏ 
<DigestValue>Dn6JYIBI/qQudmvSiMvuOvnVBGU=</DigestValue>‏ 
</Reference>‏ 
</SignedInfo>‏ 
<SignatureValue>NULghI4WbzDLrolIcf2u9aoybfSJXPJRNSOUMrCPYaS5bup+tc7RJnqTM+SzP4jmfJWPPs7pOvDC/fbdNYVMaoyXWO j‏ 
L3Lk8du3X4JXpW3xp9Nxq31y/LAdSE+Rkoi PO6KRGDI+RRZSMAQda SWS+L2 fMyenRAj o+fRIKL3sQ/hOfQX8=</SignatureValue>‏ 
</Signature>‏ 
</License>‏ 


يظهر التوقبع الرقمي كمحتوى مشفر (مشوش) ضمن العلامة<ءں 1 إن اهدو 51>.والآن إذا ما حاول أي شخص تعديل أي من قيم الترخيص»فإن الترخيص لن يطابق بعدها 
اتوقع وكامل الترخيص سيصيح غير صحيح. ۰ 

فبدل استخدام التوقيع الرقميءيمكن أن نعمل فقط على تشفير ملف التر خيص بالكامل ضمن مفتاح خاص.وفيما بعد استخدم مفتاح عام لفك تشفيره واختبار محتواه.ولكنني افضل 
التوقيع الرقميءبما أنه يسمح لاي كان من فتح ملف الترخيص واختيار بار امترات(ثوابت) الترخيص نفسه بينما ما يزال مانعاً لأي تفيرات. 


لنعود إلى تطبيق المكنبة.سيعمل البرنامج على ضبط سلوكه بالاعتماد على فيما إذا تم ترخيص آم لا.ولكن لصنع ذلك التصميم.هناك حاجة إلى ضمان أن محتوى ملف الترخيص 
صحبح ولم تتم محاولة تزويره.لعمل هذاءنحتاج إلى طريقة تعمل على فك (أو تفسر) التوقيع وتقارنه مع باقي الترخيص لضمان تطابقه.عملنا على بناء التوقيع باستخدام مفتاح 
خاص»وعلینا فکه باستخدام مفتاح عام.نستطبع تخزین مفتاح عام في ملفه الخاص خارج البرنامج»ولكن من المحتمل أن يتم فقدانه(كما يتم فقدان مفتاح حقيقي تماما).بالمقابل»سنعمل 
على تخزين المفتاح العام كمور د للتطبيق.موجود خارجياً في مجلد موار د الكود المصدري.عملت على إضافة هذا المورد في التطبيق»وسميته ر ءااub‏ ۴ء٠‏ ءءاا.بواسطة هذا 
المفتاح المضمن في التطبيقء أي إنتاج للمفاتيح العامة والخاصة ستتطلب تعديل لهذا المصدر. نشير في الكود إلى محتوى × بخصوص المفتاح العام باستخدام اسم مورده(أو 
اسم مصدرة @" 2¬ :(resource‏ 
My.Resources.LicensePublicKey ()‏ 
بعض ميز ات الاأمن تستخدم الفئات الموجودة في فضاء الأسماء ا×.رطمهاوهامرCr.رitسstem.SecuرS.وهذا‏ الفضاء ليس واحد من الفضاءات التي يتم تضمينها بشكل 
افتراضي في تطبيقات الفيجوال بيسك الجديدة.لذلك سيكون علينا إضافته بأنفسنا. افتح نافذة خاصيات المشروع e۴5‏ م٥٣م‏ أاecزoإم‏ واختر تبويب lلمرlجg .References‏ 
وتحت قائمة المراجع»انقر الزر "إضافة ۸۵۵ ".ومن تم اختر ri‏ System.Secuمن‏ تبویب NE‏ . لنافذة إضافة مرجع ۸٩4 ۸٥۴6۲٥۸٤۴‏ التي تظهر. 
بما أن نافذة خاصيات المشروع مفتوحة» انقر فوق التبویب "إعدادات کو, )ه5 ".وأضف إعداد نص جدید واستخدم النص ¡|۴1٥٥ 2۵٤0۸‏ 5۵۴١ءء‏ نا من أجل اسمه.سنستخدم 
هذا الإعداد لتخزين المسار لملف الترخيص.احفظ وأغلق نافذة الخصائص. 
حاجات ترخيصنا العامة على طول التطبيق بسيطة إلى حدما.نحتاج فقط معرفة الحالة الحالية لملف الترخيصءوأن يكون لدينا إمكانية الوصول للعديد من قيم الترخيص بحيث 
نستطبع عرض رسالة قصيرة حول الترخيص.ر بما نحتاج إلى عمل هذا في أجزاء متنوعة من اليرنامج.لذلك لنعمل على إضافة بعض الكود الشامل #لهء ء۲٠٠‏ هو إلى الوحدة 
البر مجية 66/7٥/2/.۷6‏ .افتح هذه الوحدة البرمجية الآن. 
عند أعلى ملف الوحدة البرمجيةءيتضمن الكود مرجع إلى فضاء الأسماء System.Security.Cryptography.بما‏ ننا عملنا علی تضمین کود يعمل علی تشفیر کلمة مرور 
المستخدم.ولكن هذا لايغطي مواد ا ×المصدرية أو القياسية.لذلك أضف عبارتي كاامم"اجديدتين كما يلي. 
Imports System. Xml‏ 
IMPOEES SYSEeM . SECUEIEY. CEVPEOIEAPRY . XML‏ 
سنستخدم عداد للاشارة إلى حالة التر خيص.أضف هذا العداد الآن إلى الوحدة البرمجية ا۴۲2٣ه6.‏ 
Public Enum LicenseStatus‏ 
ValidLicense‏ 
MissingLicenseFile‏ 
CorruptLicenseFile‏ 


الفصل الثاني والعشرون:إجازة التطبيق. Mhm76‏ 


لنعمل أيضاً على إضافة تركيب بسيط يعمل على وصل القيم المستخرجة من ملف الترخيص. أضف كوده إلى الوحدة البرمجية ا۴۲2٣68:‏ 


بشكل افتراضي»يظهر ملف التر خيص في نفس دليل التطبيق باستخدام الاسم .أضف ثابت شامل إلى الوحدة البرمجية اة6۲٣٠6والذي‏ يعرف هذا الاسم الاقتراضي. 


As 


کل ما نحتاجه الآن بعض الکود لملئ الترکیب‌انه ۴|۵٥0‏ ٥ءء[‏ .أضف الدالة ۵ہءء ناما" ه×ع التالي 


My 


New 


الفصل الثاني والعشرون:إجازة التطبيق. Mhm76‏ 


Return 
ma UE 


Then 


RE UE 
الذي استخدمناه أيضاً لاإنتاج ملف الترخيص الأصلي يحتاج إلى معرفة بالضبط أي علامة ا ×تمثل التوقيع الرقمي ضمنه.ستفكر أن وجود عنصر مسمى‎ او٠٠‎ 4×"١ الكائن‎ 
كشف كبير»ولكن من المحتمل أن لايكون كذلك.على أية حالءحالما تعمل على إسناد تلك العقدة باستخدام الطريقةا١×20٠٠.١١×4٠٠واS .تستطيع استدعاء‎ نوكيس>Siوntuإe<‎ 
الطر يقة٠إا†ة”واS)ءهcn .ممرراً لها المفتاح العام.إذا أعادت صواب.فإن الحال جيد أعني أن الكود لايعلم أي شيء عنك»ولكن التوقيع جيد‎ 


عندما عملنا على إضافة الفورم"حول البرنامج ۲4٣"‏ و١هإu1۴هطA‏ "إلى المشروع»عملنا على تضمين أداة لصاقة مسماة ٠5#١‏ ٠اا‏ طةا.وهي تعرض في الوقت الحالي وبشكل 
دائم "غير مرخص"»ولكن الآن لدينا أدوات لعض الترخيص المناسبءإذا كان متاح.افتح الكود المصدري لهذه الفورم. وأضف الكود التالي إلى بداية معالج حدث تحميل الفورم 
.AboutProgram_Load‏ 
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الفصل الثاني والعشرون:إجازة التطبيق. Mhm76‏ 


If (licenseDetails.Status = LicenseStatus.ValidLicense) Then 


WANE LLTEEA SEM, HEE 3 en YN G&G ICS IODE LEL LS, LICEORIES & WOCTELE G&G ESN ell YF & 
licenseDetails.SerialNumber 
ERA TÊ 


بيين الشكل التالي الفورم"حول اليرنامج "في حال التشغيل مع التفاصيل المعروضة من ملف الترخيص.عندما أعمل على عرض الفورم "حول المشروع"مرة أخرىءفإنها 
ستعرض"غير مرخص"»بما أن اختبار التوقيع فشل.كيف أعمل على اختبار الكود بشكل ميكر ؟ عملت على نسخ ملفه// .م۸5 عء/0/2/۷1/£ من الدليل الجزئي 
ووضعت تلك النسخة في الدليل الج ز ني وسطع6/712 للكود المصدري للمشروع.فيما بعد»ستكون قادر على وضع الملف في أي مكان تريد وتعمل استعراض من أجل الحصول 


عند نقطة ماءسيكون للترخيص الفير صحبح تأثير سلبي على استخدام التطبيق.عندما يحدث ذلك.سيكون علينا منح المستخدم فرصة من أجل تصحبح المشكلة بإيجاد ملف الترخيص 
الصحيح.سنعمل ذلك من خلال الفورم الجديدةا۷ 10٥4161/85.‏ عملت على إضافة هذه الفورم سابقا إلى المشروعءوهي تظهر في الشكل التالي. 


تحديد ملف الترخيص 


لايجاد ملف الترخيص الصحيح من أجل هذا التنصيب من التطبيق»ءانقر على 
الزراليجاد". 


الموقح الحالي: 1 


تيدأ هذه الفورم في كودها المصدري باستدعاء دالتها العامة#ء٠٠ءناه‏ و١٠٣٥‏ .التي تعود بصواب إذا غير المستخدم الترخيص.معظم كود هذه الفورم يعمل على إدارة العرض. 
وإحضار تفاصيل أسباب صحة أو عدم صحة الترخيص باستخدام تتائج الدالة .فإذا كان الترخيص لأي سبب غير صحيح.فالنقر على الزر"إيجاد..." يتيبح للمستخدم الاستعراض من 
أجل إصدار أفضل. 
يعمل المتغير اناه الذي على مستوى الفورم على الرجوع إلى المستدعي كبادئ من جديد من أجل إنعاش حالة الترخيص.من أجل تطبيق المكتبة بشكل خاص لا 
أرى نقطة للتأكيد على الترخيص عند البدء.بما أنه ليس خطأً الزبون في أن تسرق المكتبة هذا العمل البرمجي الها.بالمقابل عملت على تأجيل عملية التحقق حتى المدير أو أمين 
المكتبة يحاول الوصول إلى الميزات المحسنة للتطبيق.عندهاءإذا فشل اختبار الترخيص»سيكون المستخدم قادر على استعراض الديسك(أو القرص )من أجل ملف ترخيص صحبح. 
أظن أن المكان الأفضل لإضافة اختبار الترخيص هو بعد أن يعمل المدير على كتابة كلمة المرور بنجاح مباشرةءإذا اختبرنا قبل تلك النقطةفستمنح الزبون العادي القدرة على 
استعر اض القرصء»والذي يجب أن لايحدثءلذلك افتح الكود المصدري من أجل الفورم ٥7279٥158۲١۷6‏ ءوابحث عن معالج الحدث )ءاا۸10۸_C‏ واعمل على إيجاد التعليق 
"تسجیل دخول ناجچ": 
'تسجيل دخول ناجح 
LoggedInUserID = CInt (dbInfo!ID)‏ 
LoggedInUserName = CStr (dbInfo!LoginID)‏ 
قبل مقطع الكود هذا أضف كود اختبار الترخيص التالي: 
ا a‏ الل لادا كان اال امم ار سا 
e Maa le (Exams Nen eem se (J SEAEUS‏ 
LicenseStatus.ValidLicense)‏ 
J‏ سو ل ۱ 1 م م N‏ ر 1 5 
TE (MESS (A i N E CD BSA EE BM E MS EN ES EC _ O SE‏ 
| ك ل الل ارا 
NS aN NRT FOND OGD CECT EG COE DN a TC N‏ 
OES MSSBOxXSEYI E HESIN OE‏ 
MsgBoxStyle.Question, ProgramTitle) <> MsgBoxResult.Yes) Then‏ 
dbInfo.Close ()‏ 
dDInREO 5 NoEhInNG‏ 


RE EUER 
End UE 
اللطلت من احاح عدت ارجح‎ 


Call LocateLicense.ChangeLlLicense () 
LocateLicense = Nothing 
Loop 


هذا يمنح المستخدم عدد غير محدد من الفرص لايجاد ملف الترخيص المناسب.حالما يتم التحقق من ملف الترخيصبيتقدم الكود إلى الأمام ويمن الوصول الإداري. 


المجموعة الأخيرة الرئيسية من الكود التي سيتم إضافتها إلى مشروع المكتبة غير متعلقة بالترخيص. ويالرغم من ذلك فهي هامة:معالجة الغرامات من أجل البنود المتأخرةءسنعمل 
على إضافة طريقة مشتركة تقوم بالمعالجة.ومن ثم نستدعيها عند الحاجة على طول التطبيق. 

أضف الطريقة yرم a٥١۸٥‏ y۴رyProcess8اaiطالجديدة‏ إلى الوحدة البرمجية ا66"۴۲2: 

Public Sub DailyProcessByPatronCopy (ByVal patronCopyID As Integer, ByVal untilDate As Date) 
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الفصل الثاني والعشرون:إجازة التطبيق. 


1 
ITI 
0 


ON EEO GO 


Then 


False) Then 
Then 


End Sub 
يختبر هذا الكود السجلرم ه٥ ١١١ه۴ .السجل الذي يرمز إعارة بند واحد من قبل زبونءلرؤية فيما إذا كان متأخرءوإذا كان كذلك.ما هي العقوبات ااه" هم التي سيتم إضافتها‎ 
للتأكيد على‎ ۴۲٥١٠١65502 .لانريد أن نغرم الزبون مرتين في نفس اليوم من أجل بند متأخر واحد(ولن نفعل ذلك).لذلك نستخدم‎ ۴٠٠6552 إلى السجل.يتضمن كل سجل حقلهاة‎ 
. ں٢ أي الأيام الغير محملة بالغرامات لع و۸2۲ء‎ 
ءالفورم التي تعمل على إظهار‎ ۴٠٥١۸٠ ٤0۲١مروفلا توجد عدة أمكنة على طول التطبيق حيث أننا نريد استدعاء روتين المعالجة هذا بدون مضايقة المستخدم.الظهور الأول في‎ 
الفرامات المستحقة على زبون.قبل إظهار تلك القائمة تماماًء سنعمل على تنشيط كل بند تم إخراجه من قبل الزبون لضمان أننا نعرض معلومات الغرامات الأحدث.افتح الكود‎ 
الذي يظهر في‎ Refres۸ ۴2ء٥۸۴,‎ ٥5)-1( المصدري لتلك الفورم»اعمل على إيجاد معالج حدث تحميل الفور مك2٠ ا_١0۲ء ٠۸١٥ء۴ .وأضف الكود التاليءقبل استدعاء‎ 
منتصف هذا الروتین.‎ 


الل الاي واوو ن اة الق Mhm76‏ 
حالة التأخير لبند يجب أن يتم تنشيطها أيضاً قبل إدخاله.افتح الكود المصدري للفورم الرئيسي ۸۴٥۲۳٣‏ 1ة واعمل على إیجاد معالج الحدث :ا٥‏ _ Act D0 C۸٥)!‏ .ستجد التعلیق 
الذي يبدأ ب" معالجة البنود المفقودة". قبل التعليق تماما ادخل الكود التالي: 


تحتاج الإخراجات أيضاً تنشيط غر امات زبون.قبل السماح لزبون من معرفة فيما إذا كانت موجودة.في الحقيقة. أي غر امات مستحقة.مازلنا في الفورم الرئيسية »انتقل إلى معالج 


الحدث atron_ Cie)‏ ActcheckOutP.وأضف‏ التصريح التالي لأعلى هذا الروتين: 


في هذا الروتين اعمل على إيجاد التعليق الذي بيدأ ر" ' ".وكالعادة, أدخل الكود التالي قبل هذا التعليق: 


بالاضافة إلى المعالجة التلقائية للغر امات»يسمح مشروع المكتية أيضاً لمدیر أو مين المكتبة من عمل المعالجة اليومية لجميع بنود زبون عندما يريدون.وهذا يحدث من خلال لوحة 
"المعالجة اليومية"عل الفورم الرئيسية (شاهد الشكل التالي). 


تسح للد هذه اللوحة عمل معالجة بومية والدي تحدث سجلات بند السكبة والزبون | 


E‏ بالقيم مثل غرامات التأخير والمدقوع وحالات التأخر 
9 بند المكنبة 
E 8‏ ا تم تحديت المعالجة. 
2 تعلیمات 
موضع لمعالجة؛ 


5 
م( 


حالياًلاتعمل هذه اللوحة أي شيء.لذلك دعنا نغير ذلك المهمة الأولى هي تحديث حالة اللصاقة التي تظهر أعلى اللوحة.أضف طريقة جديدة مسمöl RefreshProcessLocation‏ 
إلى الفورم الرئيسية ١۴٠١۲۳‏ اج“ كما يلي: 
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الفصل الثاني والعشرون:إجازة التطبيق. 


يعمل هذا الكود اختبار على حقل قاعدة البيانات و”iءءەء٥٣1۴ء1a.‏ ”نامهد ,وأيضاً على جمبع المواضعءأو من أجل الموضع المختار من قبل ا E‏ على 
تحديث حالة العرض تبعاً لذلك. 

يختار المستخدم موضع من أجل المعالجة بالقائمة المنسدلة"موضع المعالجة"ولكننا لم نعمل على إضافة أي كود يملاً هذه القائمة.اعمل على إيجاد الطريقة sكععه۴۲‏ )كج۲ في 
الكود المصدري للفورم الرئيسية وأضف التصاريح التالية لأعلى هذه الطريقة: 


OM EEE GE 


ومن ثم أضف العبارات التالية إلى نهاية هذه الطريقة: 


CINE 


ByVal As Handl 


الفصل الثاني والعشرون:إجازة التطبيق. Mhm76‏ 


وان اتخزب الكوو تغل النر اة أغل على أبكاد ماف التر كم السك وكرت الزات الكارة اة 
والآن مع نهاية هذا الفصل فإن الكود الرئيسي تقريباً انتهى ومشروع المكتبة جاهز للعمل الآن»ولكن بقيت بعض الأمور البسيطة.مثل تعلم بعض الأشياء بخصوص آسبي دوت نت 
AP.‏ .وهو موضوع الفصل القادم. 
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القضل لفات و اتون تون الو Mhm76‏ 


تطوıر‏ |Jلgويب Web Develop nent.‏ 
عندما اخترع السير تيم بيرنرز لي الشبكة العنكبوتية العالمية الواسعة في عام 1989ء في الحقيقة لم تكن صفقة كبيرة.بما أن المصمم 
الرئيسي لبروتوكول نقل النصوص الفائقة ۳17۲۶۲)أو llلnدaجةProtocol Hypertext Transport (or Transfer)‏ ) و HM‏ لم يظهر بعد.ولکن 
معظم التقنيات التي تدخل في تركيب ونقل صفحات الويب كانت موجودة منذ سنوات وحتى عقود.فلغة الترميز المعممة المعيارية 702/١‏ 2ا5 
Generalized Markup Language‏ (أو القياسيةا56۷ ) (أساس لغة ترميز النصوص الفائقة ٤و2 per 7 ext M2r) up 129 u‏ أو HM‏ )وأنظمة 
الربط المدمجة كصعاكرء وkinمiا-مممhy‏ كانت موجودة منذ عام1960.ونقل البيانات المعتمدة على Jlانترنٽت Internet based transmissi0¬ Of‏ 
هاه بين العملاء والمخدمين كانت شائعة بين شبكات الجامعة university campuses‏ وبعض الأعمال.مانزال ونحن في بداية القرن 
ال21.والشبكة العالمية هي المركز لكثير من تقنيات الكمبيوتر والتي تجعل راسي يدور.الفضل كله للسيد بيرنرز لي. 
تروج ميكروسوفت للدوت نت على انه نظام تطوير صفحات الويب والبرمجيات ذات الصلة.وفي الحقيقة إنه نظام عظيم.فعندما ندخل في الكودء 
سنجد حوالي %90 من ما تعمله لكتابة تطبيقات الويب في الفیجوال أستودیو مشابه لما تعمله عندما تكتب تطبيقات سطح المكتب.إنه سهل 
العملءونوع من المتعة.لذلك ومن المحتمل أنك تريد كتابة بعض البرامج باستخدامها.وهذا ما سنعمله في هذا الفصل.ولكن في البداية»دعنا 
نوجز مراجعة لما حدث في عالم مخدم-عميل ١58۲۷۵-١ء‏ اء لاتصالات الشبكة العنكبوتية العالمية . 


عل الو ت ور اا E‏ 'عبء ٿقيل وممل. ET SS TT‏ 
لاتوحد لفات E‏ .فقط نصوص بسيطة :زتها قوز وة تنائية أو كلاهما. ‏ 

مستعرضات الويب(أو الشبكة العنكبوتية) الأولية كانت في الحقيقة مجرد برامج نسخ ملفات عظيمة.وعندما تشغل مستعرض 10521٥‏ (الذي 
كل ما كان في تلك الأيام)وتطلب صفحة ويب من كمبيوتر أخر,ءإليك ما كان يحدث: 

1.يحدد مستعرض الويب عنوان برتوكول الانترنت ك5٠۲‏ 0ه ۴| للنظام البعيد. 

2.يتصل مستعرض الويب بالنظام البعيد بواسطةاهع0اهrم‏ 1nternet/اrotocoمp‏ اcontro transmission‏ (او برتوکول التحکم في الإرسال/برتوکول 
الانترنت ) المنفذ ذو الرقم 80 . 

3.يقبل النظام البعيد الاتصال. 

4.يقول مستعرض الويب"مرحباءإني أبحث عن ملف مسمى./7۵6×.۸17/ .هل تستطيع إرساله لي؟" 

5.يقول النظام البعید"إنه لدي" .ومباشرة یرسله له. 

6. يعمل النظام البعيد على إغلاق الاتصال. 

معظم هذه المعالجة مخفية »ولكن تستطيع رؤية حدوثها.إذا كنت مهتم افتح موجه أوامر ويندوز»واكتب الأ التالى: 


هذا یشغل برنامج تیلنت ا0٤‏ 0٤٥۲م‏ )0۲ "eW‏ (برتوكول انترنت)» أو برنامج المضاهاة الطرفي 2۳٣وهام‏ ٣0ناةاu"ه‏ اق٣أ"۲ه†‏ الذي يتيح لك الاتصال 
إلى الأنظمة البعيدة من خلال واجهة نصية۴٥ |١8١۴‏ × .(يتم تنصيب ١٠١ا٠على‏ نظام ويندوز ۴×بشكل افتراضيء»ولكنه اختياري في نظام 
فيستاءتستطيع إضافته إلى فيستا من خلال لوحة التحكم وميزات إضافة مكونات ويندوز.)عادة»يتصل تيلنت إلى المنفذ23»ولكن تستطيع تعين 

أي منفذ ۲٥0متريد»كما‏ فعلنا هنا مع المنفذ الافتراضي للشبكة العنكبوتية العالمية وهو 80. 

يمكن أن تبدو شاشتك فارغة»أو ريما تبقى في مكانهاءوتبدو كالجامدة»إذا كنت محظوظ سترى رسالة "الاتصال"»ويمكن أن لا تراها.وكل شيء 

على مايرام. يعمل نظامك على الاتصال بمخدم الويب التابع لغوغل.اكتب الأمر التالي: 


اتبع هذا السطر بضغطتين خفيفتين على مفتاح إنتر.يطلب هذا الأمر من النظام البعيد إرسال صفحة الويب الافتراضية عند أعلى التسلسل 
الهرمي لمخدم الويب ذاك.ولأنك سألت فسيكون: 

TE 1 ~0 200 O 

CaAene< COREEOLS PEI VEIEE 

Content-Type: text/html; charset=I1S0-8859-1 

Set Cookie: BREE ID IECEIAIIA42646ESEI TM 11999259226 

:LM=1199325226:S=P1-4f1fg4yh8Mvw7; 

EXPEC S SAE) O2 JAM ZONO OSS S246 CMM, 

path=/; domain=.google.com 

Server: Qguws () 

Dates lue, Ol Ua 2008 O1 290500 GME 

Connection: Close () 

<html><head> 

..rest of HTML web page content here... 

</body></html> 

Connection to host lost. 

بالطبع لاترى عادة كل هذا.يعمل مستعرض الويب على تحمل هذا الحوار عنك»وينسق بشكل جميل الاستجابة كصفحة ويب.هذا عملياً كل ما 
هنالك بخصوص الشبكة العنكبوتية العالمية.حيث أنك جربت فقط الميزات الرئيسية المضمنة:نقل البيانات الأساسية من خلال منفذ۲/۱۴٥۲‏ . 


كانت الصفحات الستاتيكية(الساكنة)جيدة لفترة من الزمن.ومن ثم أصبح الانترنت ممل.أخيرآءجاء أحدهم بفكرة ساطعة:"لدينا برنامج يعمل 
على شخدم الويب ويسخجتب للزباتن:وخذ يهم بالضفحات المطلوة .ما الذك خضل إذا ما استطفنا تحسين ذلك البرنافخ يجيت من أجل ضفحة 
معينة»سيستدعي برنامج أو صيغة ستعمل على توليد محتوى ا۳۲۷ أثناء التشغيل أو المعالجةءونعمل على إرجاع ذلك المحتوى إلى 
العميل؟"لذلك.عملوا على تغير معالجة المخدم.والآن»عندما يطلب العميل صفحة الويب التي تنتهي بالامتداد/وء. عملية مخدم الويب تشغل 


القضل ,تالت و الفترون تطوير الويت: Mhm76‏ 

صيغة منفصلة تعمل على توليد المحتوى.و النظام أيضا مزود بوسائل من أجل محتوى موفر من قبل العميل ليشق طريقه إلى الصيغة» جاعلاً 
من الممكن تخصيص وتطبيع الميزات. 

من هناك كانت الخطوة القصيرة للحل الشامل.على منصة ميكروسوفت.»الوظائف الإضافية 00-1١١‏ المدعومة بخادم معلومات الانترنت اع"/عا۸/ 
Server‏ 0rmati0n/م/‏ التي يمكن استدعاءها بالاعتماد على امتداد الملف للملف المطلوب.وهذا يقود إلى صفحات الخادم النشيطة ع٥Ac//۷‏ 
)AS۶P( Sever Pages‏ .حل يتيح للمطورين تضمين صيغة من قبل الخادم(غالباً باستخدام صيغة الفيجوال بيسكأمااء VBS‏ .تشكيلة ما 
لفيجوال بيسك) في محتوی ا1۲۷تماماً»وعلیه تعدیل المحتوی قبل أن يتم إرساله إلى العميل. 

قال شخص آخر"إذا كان يإمكاننا كتابة صيغ كأمأا»ءعلى جهة الخادم ألا نستطيع تضمين"صيغة العميل(الصيغة المكتوبة من قبل العميل)"تماماً 
في محتوى ا۳1۲۷بحيث يمكن لمستعرض ويب حاذق معالجتها؟"قبل زمن »كان كل من مطوري جهة العميل ٥ه‏ اء-أ١ءااء‏ وجهة الخادم 
side-امvاهs‏ في حالة حرب معلنة في الشوارع»ولكن المعركة لم تستمر لفترة طويلة لأن معظم المبرمجين كانوا قد استنفذوا طاقاتهم 
exhausted.السبب؟البرمجة‏ في صıغة2^¬™i^9gثڵD[09 SCrİp‏ !فإما تضمين الصيغة في ا1۲۷ (جهة العميل هه اء ٤٣ءناء‏ )أو توليد ا1۲ من 
صيغة(جهة الخادمه 0 اء ام۲۷هء )البرمجة بالصيغة مرهقة» بطيئة»"سيئة"»وغالباآً من المستحيل التصحيح بشكل تفاعلي. 

بعض مبرمجي الصيغة لم يستخدموا مترجم اللغة لسنوات»وكانوا على حافة السقوط واومها fه‏ موم هط في غيبوية إغراء الصيغة المميت 
script ndلuced commas‏ اfta.تستطيع‏ ترجحمة بعض المنطق المتصل بجهة الخادم إلى "مكتبة الربط الدیناميکكية.aryثiD| dynamic linked‏ "و 
اا0وتستخدمه لمعالجة صفحات الويب»ولكنه بعيد عن السهولة»وهذه كاا0ستبقى غالبا مربوطة إلى محتوى ا1۲۷ بواسطة الصيغ 
القصيرة. .من تم جاء الدوت نت ودعمه لتطوير تطبیق من جهة الخادم المترحم.تنفس مبرمجي الصيغة الصعداء »فبامکانهم الآن استخدام الطاقة 
الكاملة للغات الدوت نت والفيجوال أستوديو لبناء محتوى ا۷ 1۲.وهذا النظام الجدید ۸8۴.٤1‏ ,تم تصميمه بحيث تستطيع صنع تطبيق ويب 
بالكامل دون حتى النظر إلى سمة ا1۲۷ واحدة.هدقف التصميم: جعل تطوير الويب مشابه تقريباً لتطوير تطبيق سطح المكتب.ونجحت 
ميكروسوفت على نحو عظيم.فهي لم تحل مشكلة صيغة العميل(وريما قريباً) ولكن بعض ميزات جهة العميل الجديدة المضمنة في AS۲۴.۸N٤۲‏ 
الصفحات التي تبنيها في ۸8۲۴.٤۲‏ تدعی نماذج الویب‌5٣۳١١٠۴‏ ط٥۷‏ .ولأنها مربوطة بإحكام مع بعضها البعض»فاستخدم في بعض الأحيان 
۸8۶.NE1‏ ونماذج الویب بشکل تبادلی. ولکنهما لیسا نفس الشيء» بالضبط:ف ۴۲.. ۸58۴۶ یتضمن نماذج الویب۳۶ ۴۵۲ Web‏ . 


يتضمن ١٤48۲.Nالعديد‏ من تقنيات تطوير الويب المتقدمة الجديدة.إليك فقط القليل من التقنيات الأكثر شيوعا: 


كل الكود الذي تکتبه من أجل تطبيقات آسبي دوت نت ۸5۶.٤۲‏ مترجم بالكامل إلى مجمعات مكتبات الربط الديناميكية للدوت نت اا٥ .NE۲‏ 
iesاssembه.عندما‏ يطلب العمیل ملف بالامتداد×مءه..یعمل خادم معلومات الانترنت |nternet |nfor "a٥۸ 5e6‏ على إیجاد ھذا 
الملف(والذي يحتوي محتوىی HTML/ASP.NE1 ”Jgتzم gİHTML‏ .(4ھ DLL‏ المترحم المرفق»ويستخدمهما مع بعض لمعالجة محتوى 


صفحة.تستطيع عمل ترحمة سابقة ل اا0 قبل نشره.أو تستطبع ترك ۸8۲.۸۴۲ أن يعمل على ترجمته أثناء معالجة الملف×مءة. للمرة 
الأولى التي يتم استدعاءه فيها(يسبب هذا أيضاً القليل جداآً من إزعاج الأداء). 


يمکن لتطبيقات آسبي دوت نت ۸5۶۴.٤۲‏ الوصول إلى مکتبات فئات إطار عمJ‏ lلئدوت‏ iتariesٽLibr .NET Framework Class‏ 
بالكامل(ا٣٤۴)ء‏ ما عدا تلك التي تستهدف تطوير تطبيقات سطح المكتب.فأياً من الميزات والفئات التي لديك في تطبيقات الدوت نت لسطح 
المكتب»موجودة في تطبيقات الويب أيضاً. 


وسمات ا۷ 1۲.ءمثل وسمة <ه6ها×6ا>.هي في الحقيقة مجرد نصوص(أو سلاسل حرفية) ضمن ملف اN‏ ۸1۲ نصي أكبر. يعاملِ آسبي دوت نت 
عناصر صفحة ويب ككائنات حقيقية»مجهزة with‏ eteاcomp‏ بالخاصيات iesاerم0اموالأحداث5ا٣۷6٠‏ .وبعض هذه الكائنات ينفذ أدوات جهة عميل 
معقدةءيتم تجهيزها بالمئات من أسطر صيغة جهة العميل ا۲ء #لاء-ا١‏ هنا التي تحصل عليها بالمجان. 


إدارة صيغ جهة الخادم و اا0 الخاصة قبل الدوت نت لم تكن بهذه السهولة.إنشاء أنواع من التغيرات يتطلب إيقاف كامل لخادم معلومات 

الانترنت» أو على الأقل الحصة التي تتحكم بكون التطبيق قد تم تفيره.يتيح لك آسبي دوت نت بعمل تفيرات على نظام الإنتاج دون التأثير على 
عمل المستخدمين.إذا بدلت اا0 المترحم سيعمل ۲٤..S۶؟۸‏ على بدء استخدامه مباشرةء ولكن سيبقى محافظ على النسخة القديمة حتى 
ينفصل 4١1۴٥٤ه6لجميع‏ العملاء الموجودين منها. 


كائنات صفحة الويب التي تستخدمها قي آسبي دوت نت تتولی مسؤولية إنتاج ا ومحتوى صيغة جهة العميل .العديد منها تأخذ قي 
خسیانها نوع مستعرضص العميل وإصداره»محسنة أو مخفضة الميزات بشکل آلي عند الحاجة .وکمطور آسبي دوت نت.ليس عليك حتی معرفة 
| الذي سیتم استخدامه. 


إذا كنت تريد تحسين عنصر صفحة ويب تستطيع الاشتقاق من فته وإضافة الميزات المحسنة الجديدةءتماماً كما تعمل مع فئات الدوت نت 
الأخرى.بالطبع توجد ميزات عظيمة أكثر من هذه القليلة التي جدولتها هنا.ولكن من المحتمل أنك تريد رؤية ۸8۴.۸۴ في حالة العملءدعنا 


نبداأ. 


لنعمل على بناء تطبیق ASP.NET‏ بسیط .ونتفحصه واجزاءه لاکتشاف كيف يبدو. 

ابدأ الفيجوال أستوديو واختر قائمة ملف ۴ا۴>> موقع ويب جديدهاا؟S‏ ا۷۷6 سه" .يظهر نموذج الموقع الجديد(شاهد الشكل التالي).على 
خلاف تطبيقات سطح المكتب»يجب عليك أن تخبر الفيجوال أستوديو مباشرة أين ستعمل على تخزين الملفات.سنختار موقع على نظام 
الملفات المحلي»ءولكن يتيح لك هذا النموذج أيضاً العمل على موقع ويب بعيد بواسطة برتوكول نقل Jlلملخفاٽت)protocol(FTP gİ file transfer‏ 
۶ أختر قالب موقع ويب لأسبي دوت نت6)؟ ۷۷6۲ ۸8۶.٤۲‏ .أدخل مسار الدليل حيث تريد أن تخزن الملفات.وانقر الزر موافق0©K‏ . 


القضل لقانت و ال وون تن الو Mhm76‏ 


Hew Web Site 


Templates: .NET Framework 3,5 7 E El 


¥isual Studio installed templates 


| ASP.NET Web Empty Web WCF Service ASP.NET ASP, NET 
Seryice Site Reports W,,, Crystal Re,,, 


O E a 


My Templates 


ا 


Search Online 
Templates... 


Aã blank A4SP. NET Web site (.NET Framework 3.5} 


Location: File System r |) Cine 4 Browse... 1 


Language: sual Basic R2 


ceni) 


يبين الشكل التالي بيئة التطوير بعد النقر على زر موافق في الشكل الأعلى وأشرطة الأدوات المعروضة هي كل ما أفضل ظهوره. 

لوحة مستكشف الحلول تبين تلات ملفات ومجلد تم تضمينهم في المشروع.إذا ذهبت إلى دليل المشروع»الموقع الذي عملت على تحديده 
في الشكل العلوي»سترى نفس هذه الملفات الثلاتة. الملف و١”هء.66س‏ هو ملف ا/۷×يحتوي على الإعدادات الخاصة بالتطبيق»وهو على 
صلة بالملف وأأ”٣هء.مم4ةالمستخدم‏ في تطبيقات سطح المكتب.إن الملف ×مئه.ا/اة/26 هو صفحة الويب نفسهاء والتي ستحتوي على مزيج 
من ا۲و وسوم آسبي دوت نت ءو ها ۸S۶. ٤۲‏ الخاصة والتوجيهات(التعليمات5ه۷اء ۲6ا ).والملف ط۷.×مءئ4ا/يه/26 ذو الصلة يحتوي كود 
الفيجوال بيسك"الكود المخفي' َ المصدري الذي سنعمل على ترجمته إلى اا. 


30 new - Microsoft Visual Studio 
File Edit View website Build Debug Format Tools Test Window Help 
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121003 a25 7 EET | 


Default.aspx | Start Page 


a 
E CHinew', 


i-1 


E 
Ê] Default. aspx. Yb 
Eğ web.config 


1 


Default.aspx Web File Propı 
ا‎ 


File Name Default.asp» 


File Name 
Name of this file, 


Ld Design | O split | E Source shtml | | body * | | SForm#form1 2 | | diy 


FF Error List | E GUEpuuk | 
Ready 


تعمل الفيجوال أستوديو أيضاً على إنشاء مجلد خر 1 20081Projects|/VebSite‏ usernamel|Documents|VisualStudioاsersل.يحتوي‏ هذا 
المجلد على ملفات الحل التي يتم إنشاءها عادة مع مشروع الفيجوال بيسك. حيث يتم وضعها خارج المسار بحيث لايتم تضمينها مع موقع 
الويب الموزع.المنطقة الفارغة التي تراها في الفيجوال أستوديو هي صفحة الويب» منتظرة النص ومحتوى أداة .ذا کنت ترید البرهان»انقر زر 
مقطع المصدر في الزاوية اليسارية الدنيا من العرض»أو استخدم قائمة عرض ۷6W‏ >> قائمة الترميزا١6"‏ مu N.2۲)‏ .تتفير النافذة إلى 
الكود المصدري ل ا١‏ 1۲. 
Ed Eade HanSUages VBI AUESEVERNENIEEUSS false COMER IIe Der aul E SEX O EES e aE o‏ 
CIDOCTYEE heml BUBLICG TWICE DED XHIML TO TranSt CI ONA ILVVENE TOE EDE LUN MO. OE GIR xe MUI 7 DTD XEM DD >‏ 
EEARS IN e ORaA LG EA‏ 
<SREmM1 xmlns="htEtp: //uwwuw.wS.Org/1999/xhtmll>‏ 
<head runat="server">‏ 
<title>Untitled Page</title>‏ 
</head>‏ 
SBOodyz‏ 
<form id="form1" runat="server">‏ 
A>‏ 
AO‏ 
CV ESEN‏ 
BOYZ‏ 
VRE‏ 


حسناً معظمه ا 1۲.يوجد سطر في الأعلى دا ب@%> وهو لایبدو مشابه ل 81M‏ حقيقي- وهو كذلك.»إنه تعليمات صفحة آسبي دوت 
نت. وهي تتضمن خاصیات تساعد علی توجيیه آسبي دوت نت في معالجة الصفحة .مستعيرة المعيار من سلف 8۶السابق»یستخدم آسبي 
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القضل اقلت والعشر ون تطرير الوب Mhm76‏ 

دوت نت زوج القوسين <#%...%> لتعليم أوامر معينة لآسبي دوت نت والكود.(من المحتمل أنك تميز هذه العلامات من الفصل13»حيث أنه يتم 
استخدامها في محرفية (XML Literals‏ 

هذا كافي بالنسبة ل ا11 .فمن يرغب برؤيتها على أية حال؟انقر زر مقطع التصميم”9اءه0 .أو استخدم عرض View‏ > >المصمم ۸6۲ Desig‏ 


للعودة إلى الصفحة الفارغة. دعنا نعمل على إنشاء تطبيق يضرب عددين مزودين من قبل المستخدم مع بعضهما ونعرض الناتج.من أحل هذه 
ال البسيطة أن نكتب فقط بعض أمأ٥4۷858ل‏ ونضمنه كصيغة على جهة العميل»ولكننا نحاول تجنب عمل أشياء مثل هذه.اکتب 


To multiply two values together, enter them in the 
text fields, and click the Multiply button 


لقد جعلت الكلمة رام) اس۷ بخط غامق باستخدام ٥۲١-8‏ كما أفعل مع معالج الورد.اضغط إنتر مرة ١6١‏ واحدة.بشكل افتراضي. تخطط صفحة 
الويب جميع العناصر مثل مستند معالجة الورد باستخدام طريقة تدعى "نمط التخطيط السیاقع ٣٥۵‏ اام رها 0۷W‏ ".تستطيع أيضاً استخدام 
الحط(التموضع)المطلق و٣‏ 0ناائمم ع/0ءط4للعناصر المستقلة لوضعها عند موقع معين على الصفحة.توجد طريقة أخرى لتنظيم العناصر 
على الصفحة:من خلال جدول ا۷ 1۲٧.ءلنعمل‏ على إضافة واحد الآن.استخدم جدول ۴٥اط۲۵‏ >> إدراج جدولءاطة۲ )میا .عند يظهر حوار إدراج 
جدول»عين جدول مخصص مكون من ثلاث صفوف وعمودين.ومن تم انقر موافق.سيظهر الجدول بشكل مباشر في الجسم ل00۵لصفحة الويب. 
اكتب في الخلية العلوية اليسارية 1 ١٣هإهم0واكتب‏ في الخلية التي تحتها 2 ١٣هإمم0ستبدو‏ صفحتك كما هو مبين في الشكل التالي: 


لضرب تيمتين مع بعضهدا أدخلهسا في حقول نصية ومن ثم انر على الزر 'ضرب". 


operand û 


حتی الآن لم نعمل أكثر مما نستطيع عمله في المفكرة .ولكن الآن نحن الآن جاهزون لإضافة بعض الأدوات ن.إذا فتحت صندوق الأدوات×هطامم) ٤‏ 
ستری أن الأدوات ت مشابهة کثیراً لما هو موجود فقي صندوق أدوات ن تطبيق نماذج ویندوز. 
تم ت الأدوات بواسطة التخصص الوظيفي: 


ستستخدم الأدوات الموجودة في هذا المقطع بشكل عام لبناء واجهة المستخدم لصفحة الويب خاصتك.العديد من هذه الأدوات تمثل أدوات 
ويندوز قياسية بالتوافق المباشر كما في عالم نماذج ويندوز.على سبيل المتال المدخلة صندوق قائمة ×ه8اءنا تنفذ أداة صندوق قائمة ×180ءذا 
ویندوز قياسية صضمنِ صفحة ويب. .بالنسبة لك »کمبرمج»تبدو هذه الأداة مثل فئات أداة الدوت نت القياسية»مع 

الخاصيات. الطرق. والأحداث.بالنسبة للمستخدم النهائيءفإنها تبدو مثل أداة صفحة ويب قياسيةءتم ا باستخدام 1۲۸۷1 العادي. 

بعض من هذه الأدوات أدوات مركبة»والتي تستخدم أدوات مبنية من عدة أدوات ن تعمل مع بعضها. من المكن مع صيغة جهة العميل عمل بعض 
هذاا 


أدوات البيانات تعالج تفاعلات تحزيم قاعدة البيانات. كما تتذكر من الفصول السابقة.لست معجب بربط الأدوات في التطبيقات القياسية.ولكن عند 
تربط بيانات ساكنة(ستاتيكية)من خلال صفحة ويب فإنها تتحول بالفعل لأن تكون صيانة عظيمة للوقت.بعض هذه الأدوات تعمل على تحزيم 
البيانات» بينما بعضها الأخر يعمل على جلب(تقديم )البيانات الفعلية. 


إن المستخدمين بغاية المرح»وخاصة عندما يعملون على إدخال بيانات غريبة ضمن برنامج النوعي.التحقق من البيانات التي يعملون على 

إدخالها صعب إلى حد كبير في تطبيقات سطح المكتب»ولكن حتى إنها أثقل عند يتحدث نظام العميل مع التطبيق الذي يستضيف للكثير من 
الثواني في الساعة. تعمل أدوات التحقق على إزالة بعض العبء.فهي تختبر من أجل معظم الأنواع المشتركة من أخطاء إدخال البيانات» وتشعر 
المستخدم بالمشاكل» كل هذا بدون كود إضافي من جهتك.عندما تحتاج إلى عمل بعض منطق التحقق المخصص»تتيح لك الأداة 

custom Validator‏ إضافة هذا المنطق كمعالج حدث.أو صيغة على جهة العميل. 


ن¿ هذه المجموعة عدة أدوات مصممة لمساعدة المستخدم على التنقل من صفحة إلى أخرى أو من مقطع إلى أخر ضمن موقع الويب. 


هذه الأدوات تفلف میزات إدارة كلمة المرور وتسجيل الدخول بحيیتث يستطيع المستخدم إنشاء حساب أ1۸ا00٤0٥3‏ مستخدم جدید.وتوفر كلمة 
مثبتة الصحة(موثقة).أو عمل إجراءات أخرى على صلة بالأمن. 


هي خاوات اذوات بطع الفستكدم درا ادام رمحت وأسقاط خن مهه الوب هة اللحف هن العرض هخ للخم اغف 
طابع شخضي على العرض لتحقيق متطابات شخصة موجودة في عقله.تستطع تسجيل -حالة إعادة عرض أجرء الويب كا#ة۴ط۷6في المرة 
القادمة التي يعود المستخدم إلى موقع أو صفحة ويب. 


المقدار القليل من الأدوات في هذا المقطع يساعد على دعم التخصص الوظيفي آجاكس لآسبي دوت نت.آجاكس (صيغة جافا سكريبت و 
XM)‏ الغير متزامنة. 1× and‏ avaScriptل‏ Asynchronous)وهو‏ مجموعة من التقنيات المعتمدة على ويب يمكن أن تساعد في جعل صفحات 
الويب سريعة الاستجابة أكثرء وخاصة من خلال تحديثات الصفحة الجزئيةءهاةلمن #وهم-اهااجم .وهي تقع خلف مجال هذا الكتاب. 


ستجد هنا اداة عرض التقرير۷6۲٠0۲۲۷مه8‏ »إصدار الويب من تقنية التقرير التي شرحناها في الفصل21»فهي تعض تقارير باستخدام نفس 
ملفات التي عملت على بناءها من اجل تطبيق سطح المكتب. 


هذه أدوات ea E‏ »التي مازال یستخدمها مطوري صفحات الويب منذ سنين.توفر الفيجوال أستوديو لك بعض تدقيق 
صحة الخاصيات والمساعدة الفورية »ولكن استخدام هذه الأدوات ن مشابه لکتابة وسم مطابق مباشرة ضمن ترميز الصفحة. 
دعنا نضيف عدة أدوات من المقطع القياسي لصندوق الأدوات إلى صفحة الويب.في الخلية السفلية اليسارية للجدول الذي أضفناه سابقاءأضف 


أداة زر« امiجa ActMultiplewll‏ »وضع خاصية النص ۲×٠۲له‏ إلى رامنااں۷.أضف أداتي صندوق نص ×٥۲8×٠٣إلى‏ الخليتين العلويتين على العمود 
اليميني للجدولء ».سم أحدها .SecondOperand aãıililJlgFirstOperand‏ 


أضف أداة عنوان(لصاقةا٠طه‏ ا )إلى خلية الزاوية السفلية اليمنى من الجدول.سمها ءuل١ه۴۲‏ وضع خاصية النص ×٠٣لها‏ إلى 0(نعم صفر). 
ألم تلاحظ كيف يتم إعداد كل خاصية لهذه الأدوات فهو لا يختلف عن ما فعلناه في تطبيق المكتبة الرئيسي.بسيطءحالياًء ستبدو صفحة الويب 
خاصتك كالتي تبدو في الشكل التالي. 


لضرب يسين مع بعضهما أدخلهما في حقول نصية ومن ثم اثقر على الزر"ضرب". 
|0 ااا 1 operand‏ 
ابالا|]|]| 2 operand‏ 

1 زب 


ارجع بإيجاز إلى ترميز صا)۳"2۲ ا1۲ من أجل هذه الصفحة بالنقر على زر مقطع المصدر 8١501۲عند‏ أسفل الصفحة.إذا كنت على معرفة ب 
HM‏ »ستلاحظ الوسم<#اطةا> من أجل الجدول الذي عملنا على إضافته»ولكن ستجد شيء لست على معرفة به ضمن صف الجدول الأول. 


<table class="stylel"> 


SEE Z 
Ed 
<b>operand 1</b></td> 
EOE 
<asp:TextBox ID="firstoperand" runat="server"></asp: TextBox> 
EG 
EE 
SEES 
> 
<b>operand 2</b></td> 
EOE 
<asp :TextBox ID="SecondOperand" runat="server"></asp: TextBox> 
MEO 
WEES 
SEE 
EI 
<asp :Button ID="ActMultiple" runat="server" Text="pyyرd"‎ Width="77px" /> 
EA 
d> 
<asp:Label ID="product" runat="server" Text="0"></asp: Label> 
E 
WEES 
</table> 


الوسم <asp:TextBox>‏ .فهي تبدو شيءَ ما مثل gewg۾ HTML‏ الأخرى »ولكکن لا توجد وسوم ل iHTMLبİ‏ ب " 5۲ھ" .وهذا وسم آسبي دوت 
نت خاص ويمثل فئة أداة نماذج ويب.هذه الأدوات.والمواصفات "۲ه۷هء"=اه٠د,المبعثرة‏ على طول الترميزم ا3۲۸١‏ » هي ما تجعل صفحات آسبي 
دوت نٽ ASP.NET‏ ما هي عليه. کعمليات آسبي دوت نت تجرد الصفحة×م45. وسوم هذه الصفحة المخصصة وتستدعي على الأأدوات ذات 
الصلة إنتاج مستعرض ا1۲۷1 الحيادي الخاص ڊLlg browser-neutral 11M‏ . 
انتهت واجهة المستخدمٍلنعمل على إضافة المنطق.نريد من البرنامج أن يعمل على ضرب عاملين مع بعضهما عند النقر على زر الضرب.ارجع 
إلى صفحة الويب وانقر نقرآً مزدوجاً على زر الضرب.يقفز إلى قالب الكود من أجل حدث نقر »ءا الزرء كما تتوقع منه ذلك. 
EE lal CLASS _MDO LE‏ 
Inherits System.Web.UI.Page‏ 
EOS SUS ACMONIOIS CITE NEMS SEMIET 4S OEE, SN © AS ESCO SVEN Medles‏ 
ActMultiple.Click‏ 
ERA SUS‏ 
ERE Class‏ 
هدقف تصميم آسبي دوت نت كان أن يكون لديك كود قريب إلى كود تطبيق سطح المكتب قدر الإمكان»وهذا هو.آأضف المنطق التالي إلى معالج 
الحدث هذا: 
EEG Eee Ed SUS AOU LELE CIEE BUMA SENI EE AS OONEECEY, EVAL E AS SVUSEOME EVENNESS) HARASS‏ 
ActMultiple.Click‏ 
ضرب العددين 
product.Text = Val (firstoperand.Text) * Val (SecondOperand. Text)‏ 
TE (Wal (produce E. Text) < O) Then‏ 
product. ForeColor = Drawing.Color. Red‏ 
Else‏ 
product. ForeColor = Drawing.Color. Black‏ 
ERa TÊ‏ 
End Sub‏ 


القضل الثالت والشرون تطوين اليب Mhm76‏ 
عندما كنا نكتب» ألم تلاحظ استجابة المساعدة المباشرة لكل كبسة مفتاح؟لا يمكن أن أقول أن هذا كان تطبيق معتمد على ويب»وهذا عظيم. 
اضغط المفتاح ۴۳5لبدء التطبيق.سيطلب منك تشغيل التصحيح الذي تريد عمله.وهذا سيعدل ملف التطبيقوا/ ۸۷6٥6.٤0٣‏ لدعم التصحيح 
e999‏ ل»فيما بعد ستعمل على تعطيل هذه الميزة بحيث لن يكون المستخدمين قادرين على تصحيح التطبيق. إذا فتحت الملف 
9اcon. web‏ . ستری السطر التالي: 

<compilation debug="true" strict="false" explicit="true"> 
.فهو يطلب‎ server aمماi‌cھاا‎ ٥٣م فقط اعمل على تغير مواصفة وuط٥هإلى خطأً مsامfلتعطيل التصحيح. إن آسبي دوت نت هو تطبیق خاد‎ 
الحياةء والتنفس لخادم ويب 56۲۷6۲ ط6س قبل أن يتمكن من معالجة الصفحة. .من المحتمل أن يكون أو لايكون قد نصبت خادم معلومات الانترنت‎ 
ASP.Nغ۲ على نظامك, ولکن لاتقلق. فالفیجوال أُستودیو تتضمن "خادم تطویر آسبي دوت نت خاص بها‎ امtهاnهt‎ اnfدrmation‎ Server 
"وهو موجود تماما لذلك تستطيع اختبار تطبيقات آسبي دوت نت.يبين الشكل التالي ظهور ما 9و١اأممهم صينية النظام‎ Development Server 
„system tray 


ئ ASP.NET Deyelopment Seryer‏ کا 
http: flacalhast: 1033 new‏ 


يبن الشكل التالي التطبيق المشغل في مسعرض الويب الخاص بى؛مستكشف الأنترنت. 


Untitled Page - Microsoft Internet Explorer 


ماق مر عرض المغلة ابوات_ تلات 


*“ انتقال 5ا‎ 8 ¥ httpifflocalhost:1039needefault, aspx &]| ilgi 


أرب فجمئين مح بحضنهما أدخلهما في حقرل نصية ومن تم انق على ازز اضرب" 
operand 1 K٠‏ 


operand 2 4 


6 صد ]| 


ل ترات محلية 


إذا كنت لاتحب طريقة توزيع الجدول عبر الصفحةءتستطيع تعديله باستخدام لوحة خاصيات C55‏ (صفحات النمط التسلسلية ٣25٤3 dأ ٣9‏ 
Sheets‏ عارSt).ارجع‏ إلى الفيجوال أستوديو واختر قائمة عرض ۷1W‏ >> خاصيات5ءاممها۴ C55‏ .تفتح اللوحة» عدلها نفسها بالاعتماد 
على عنصر الاختيار الحالي للصفحة.للتخلص من الصلة الغرامية للجدول مع الحافة اليمينية»اختر الجدول نفسه,تحرك للأسفل إلى خاصية 
osition/ Width‏ .و اعمل على إزالة القة 100% من مدخلة الخاصية. 


حتى الآن»يبدو تطبيقنا مشابه لتطبيق سطح المكتب»عرضت الفورم السحب والإسقاط الأولي الذي عملناه وإعدادات الخاصيات»وهي 
تستجيب لنقر الزر بالعودة إلى معالجة الكمبيوتر للمنطق.ولكن لنكن صادقين.لاتوجد طريقة تمگن تطبيق ويب أن يكون سريع الاستجابة 
للأحداثت كما هو الحال بالنسبة لتطبيق سطح المكتب.ما الذي يحدث عندما ينقطع اتصال الانترنت أو بكل بساطة يصبح بطيء؟ كيف ستعالج 
أشياء مثل أحداث 4ءو”ة۸٥۲×ه٣في‏ حقول النص؟فليس لديك إمكانية عودة صفحة الويب إلى خادم الويب كل مرة يضغط المستخدم على 
مفتاح ما. إن لأداة صندوق النص ×80×٠٣التابعة‏ لآسبي دوت نت حدثههو١ ۲٠×٤۸‏ .ولكنه لاينطلق بالنسبة لكل ضربة مفتاح.في 
الحقيقةءلايتم إطلاقه على الإطلاق(بشكل افتراضي) حتى يسبب شيء ما (مثل نقر زرءااء ١٥0ااناط‏ )رجوع الصفحة إلى الخادم.وتوجد الكثير 
من أحدات أدوات أخرى تعمل مثل هذا.فجميعها تنتظر المعالجة حتى يقوم بالمستخدم بعمل شيء» ما يعود بكامل الصفحة إلى خادم ويب. 
فقط عند ذلك الوقت يتم إطلاق الأحداث المؤجلة»وتتواصل المعالجة كالعادة.لذلك يوجد حقاً نوعين من الأحداث:النظامية 2١‏ اناوه٠والراقية‏ أو 
الاستثنائية "٣6م‏ . أعني المرجعية عهطاومموالغير مرجعيةpostback‏ -0nم‏ .الأحداث المرجعية كئا”عمرع)ءهطاءم/هي تلك التي تعمل 
على العودة بالصفحة مباشرة إلى المخدم من أجل المعالجة.أما الأحداثت الغير مرجعيةئ!”ع٠ع)ckةطاsمم-٥ N0‏ تؤجل معالجة الحدث حتى 
يعمل شيء ما أخر على عودة الصفحة إلى الخادم. معظم الأحدات إما من هذا النوع من ذاك.ولكن بعضها يمكن تفغيره .فأداة صندوق الاختبار 
checkBox‏ ديما الحدث checked Changed‏ والذي يتم إطلاقه بطريقة غير مرجعية 2٥)‏ هم-١0"‏ عندما يعمل المستخدم على تبديل حالة 
صندوق الاختبار. مهما يكن»إذا وضعت خاصية 2٥)‏ s18ءہ‏ ٥ں‏ هذه الأداة إلى صحهں۲۲ . فإن الصفحة ستعود مباشرة إلى الخادم في أي وقت ينقر 
المستخدم على صندوق الاختبار. بالإضافة لأحداث الأدوات» كامل الصفحة لديها عدة أحدات .والأكثر أهمية هو حدث تحميل الصفحة 
0ا_eوه۴.وهو‏ مناظر لحدث تحمیل الفورم ۴۵۲۳_1٥۵۵‏ من أجل نماذج ويندوزء وهو مكان عظيم لتركيب خاصيات الأدوات الأولية (التمهيدية)ء 
ملى قوائم السياق(القوائم المنسدلةءاءنا 7 d0w-مpەdr‏ )وهھكذا .سأعمل على إضافة الكود التالي إلى حدث تحميل الصفحة0 2٥ا‏ s'مومم‏ , 
sender As Object, ByVal e As System.EventArgs) Handles Me. Load‏ ا EE OEE Ee CUO EASE‏ 
E‏ 
SEOCUCE HEE = El‏ 
End Sub‏ 


والآن ستعرضص لصاقة Product‏ "ارغ" في المرة الأولى التي تظهر فيها الصفحة .الشيء الوحيد بخصوص معالج حدتث التحميل هو أنه يتم 
تشغيله مرة واحدة كلما تم عرض الصفحة.بما أن تطبيق الاختبار هذا يحافظ على استخدام نفس الصفحة مرة بعد مرة من أجل نتائجهاءفإن 
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معالج حدث التحميل E‏ من جديد كل مرة.من أجل يرنامج الاختبار هذاءفليس له أهميةءيعمل الكود في معالح حدث نقر الزر على إعادة 
قيادة ٥۷6۲۲١۵85‏ قيمته التمهيدية"فارغ".ولكن في تطبيقات أخرىءمن المحتمل أنك لاتريد الاحتفاظ بالإسناد التمهيدي للبيانات. لحسن 
الحظءسيتيح لك الحدث تحميل 44ه٠امعرفة‏ إذا هذه هي المرة الأولى»من خلال عضو مستوى الصفحة الذي يدعى )ءة18ءه۴ءا. 
IN OE EEE TT SEET ETE‏ 
"iفارغ"‏ = TE (Me.lIsPostBack = False) Then product. Text‏ 


إذا كنت أعيد تحميل الصفحة من جذورها كل مرة مع الحاجة إلى القيم التمهيدية في معالج حدث تحميل الصفحة» كيف احتفظ صندوقي النص 
بالقيم المدخلة من قبل المستخدم عند إعادة تحميل الصفحة؟فنحن لم نعمل على إضافة آي كود لحفظ وتجديد تلك القيم خلال التمهيد. إليك 
القصة.على الرغم من أن حدث تحميل الصفحة ١۵٠ا‏ _مو۴a‏ يعمل على منحك فرصة تمهيد الصفحة كل مرة يتم تحميل الصفحة»فمن اجل 
معظم الحقول ستتذكر الصفحة ما كانت عليه الحقول.تذكر أنه تم تصميم آسبي دوت نت بحیث تعتقد آنه يعمل مثل تطبیق نماذج ویندوز 
تمامآ.ولن تكون سعيدآً إذا ما فقدت الحقول على نموذج سطح مكتبك قيمها كلما نقر المستخدم زر.ولن تكون سعيدآً إذا نظف تطبيق نماذج 
ويب هذه الحقول أيضاً.لأن صفحجات الويب تكون منفصلة عن خادم الويب معظم الوقت.فتحتاجح صفحة الويب طريقة ما لتحتفظ بالحالة- إعدادات 
البيانات والخاصية الحالية لكل أداة بين تحميلات الصفحة.يقوم نظام نماذج ويب بعمل هذا من خلال ميزة تدعى"حالة العرض".إليك كيف 
تعمل:تتضمن كل صفحة ويب لآسيبي دوت نت حقل ستاتيكي مخفي يحتوي نسخة متسلسلة لجميع معلومات الحالة الهامة للأدوات.عندما 
يعمل المستخدم تغيرات إلى كل أداة ويطلق حدث ما يعمل على إعادة الصفحة إلى خادم ويب.فإنه يعمل على إعادتها مع حالتي العرض 
المضمنتين(مجمعة من التركيب السابق للصفحة)وجميع الإعدادات الحالية لكل أداة.باستخدام المعلومات المجمعة هذه»يكون آسبي دوت نت 
قادر على إعادة بناء حالة العميل المرئية الصحيحة لكل أداةوينقل ذلك بشكل صحيح لك في كود معالج حدث جهة الخادم . 
عندما تشغل تطبیق آسبي دوت نت»استخدم القائمة عرض Vi6W‏ >> المصدر S0urceقي‏ مستکشف الانترنت او فقي مستعرضك 
المفضل :وسترکی شي»ء مشابه للتالي: 
<input type="hidden" name=" _VIEWSTATE" id=" _VIEWSTATE" value="/wEPDwUKMTEyMTc3MTQWNg9KFgICAW9KFgICBW8P‏ 
FgleBFRleHQFBOSvIERhdGFKZGQME+xLedutk85TVXy9O Jd‏ 
kQFOZYA==" /> 1‏ 
هذا هي حالة العرض.لا تسألني كيف تعمل»فلن أخبرك(لأنني لا أعلم).ولكن ليس من الأهمية معرفة كيف تعمل.ما هو هام معرفة أن آسبي 
دوت نت يعرف كيف يعمل مثل هذا بحيث يستطيع حفظ تطبيقك يعمل مثل نظام نماذج ويندوز. 
عندما تضيف أدوات إلى صفحتك .تعمل حالة العرض ءه)S؟S‏ س6wااعلى‏ الزيادة في الحجم.بما ان جميع محتوى صفحة ويب يجب أن يتم نقله 
ل متكرر إلى الانترنت»وحالة العرض الأضخم تنتج في وقت انتقال أطول.من الممكن تعطيل حالة العرض من أجل أدوات معينة باستخدام 
يتما eاهاSسء۷iءاEnab.إذا‏ كنت لاتريد الاحتفاظ بقيمة أداة من استخدام صفحة إلى استخدام صفحة»فمن الجيد تعطيلها. 


لأن هذا كود بسيط يستخدم دالة لفيجوال بيسك 1ه لمعالجة البيانات المزودة من قبل المستخدم, فعلى الأغلب تعمل دائماً بدون أخطاء.أي 
بيانات تعتبر غير صحيحة يتم تحويلها ببساطة إلى صفر.يوجد خيار أخر لمعاقبة المستخدم من أجل المدخلات الفير صحيحة قبل أن تحدث 
المعالجة. لتقيم 4/0418 القيم المزودة.المدققات ك١ه0اةلiاة۷الخمس‏ في مقطع التحقق ١٥iاةهiاة۷لصندوق‏ أدوات ×٥طاههانماذج‏ ويب 
يساعدك على عمل التالي فقط: 
»تؤكد ال uiredFieldValidat0rههRعلى‏ المستخدم أن يزود أي قيمة في أداة ما. 
«يتذمر ال 0ا لاهو R2”‏ إذا لم تقع قيمة أداة بين قيمتين. 
.تيح J| dJ‏ RegularExpressionValidatorمقlرنة‏ قيمة أداة على نموذج تعبير نظامي.على سبيل المثال»تستطيع مقارنة إدخال المستخدم 
للرقم المتسلسل إلى نموذج(عينة) لضمان انه يحتوي حرفين متبوعين بخمس ارقام. 
تتضمن ال 0ال ااة۷٠إ‏ همه أداتين» تقارن القيمة بينهما.تستخدم الأداة أيضاً كمقيم نوع بيانات١0اةلاة۷‏ »مؤكدة على أنها حقل مفرد يحتوي 
على نوع مناسب من البيانات»مثل قيمة بيانات أو عدد صحيح انتغفر96۲ها”١|‏ . 
ءتتيح لك ال ااا ustom۷ععمل‏ أي نوع من التحقق الذي تريده من خلال كود توفره أنت. 
جميع هذه الأدوات المذكورة في الأعلى تعمل تحقق من جهة الخادم١‏ 0ة لاج۷ ملiء-۲م۷ءهء‏ »وبشكل اختياري تعمل تدقيق بياناتها باستخدام 
صيغ جهة العميل كأمااءء مهلاء-اممiاء(الافتراضي).فاحتواء‏ التدقيق في جهة العميل يعمل على تقليل الحاجة للعودة إلى خادم الويب لضمان 
أن الحقل المطلوب لديه بيانات.واحتواء تفحص (تدقيق)على جهة الخادم kعهإء‏ ملاء-مvهء‏ يضمن أن البيانات محققة أو صحيحة حتى ولو 
عمل العميل على تعطيل دعم الصياغة و١‏ اامااءك . 

تعرض المتفحصات(أو المدققات 0۲5ةهاة۷ )رسائل الخطأً الخاصة بهاءلذلك تعمل على وضعهم على الصفحة متى أردت أن تظهر رسالة 
الخطا.تستطيع أيضاً أن تمتلك عدة مدققات تعرض قضايا تراكمية في موقع واحد باستخدام الأداة Summary‏ iationا.‏ دعنا نضيف بعض التحقق 
إلى حقلي الإدخال في متال الضرب.نريد أن نضمن أن البيانات الموفرة»وكلا القيمتين هي انتفر صحيحة.لعمل هذاءيجب أن نضيف كل من الأداة 
Required Field Validator‏ والأداة idatorاompareVaع‏ لكل حقل.انقر يمين أسفل الخلية اليمينية من الجدول. تماما بعد لصاقة ا#طه| الناتج 
۴roduct.واختر‏ إدخال اهما > >عمود إلى اليمين أوRi to the‏ umnاCo‏ من القائمة المنسدلة التي تظهر.في الخلية الجديدة اليمينية 
العلوية. أضف الأداة ٣هاة‏ 0۴۱0۷0 ءءuiوهR.ضع‏ الخاصيات التالية لما: 
.؛ضg .FirstOperand JJ|ControlToValidate‏ 
.ضع لهامءiطإلى‏ ۳ة ر0.يتيح هذا لحجم المدقق بأن يتقلص إلى لاشيء عندما لايكون هناك خطأً سيتم عرضه. 
.ض# .Missing yJJErrorMessage‏ 
إلى اليمين تماما من المدقق20۲ اج۷ في نفس خلية الجدول. أضف ١0اةلناه۷٠۲م۳٠٥‏ وضع الخاصيات التالية لها: 
.ضg .FirstOperand yJ|ControlToValidate‏ 
.ضg .Dynamic yJ|Display‏ 
.ض# .Must be an integer yJ|ErrorMessage‏ 
.؛ضg .DataTypeCheck yJ|Operator‏ 
.ضع eمyآ .Integer J|‏ 


الفصل الثالث والعشرون:تطوير الويب. Mhm76‏ 

أضف زوج مشابه من الأداتين السابقتين إلى الصف الثاني من الجدول»استخدم مم40 هءمSمن‏ أجل eاiaاr01۲0۷aاC0n.ستبدو‏ صفحة 
الويب مشابهة للشكل التالي. 

شغل البرنامج وحاول إدخال بيانات خاطئة في خلايا الإدخال.ستغتاظ(تعترض)الصفحة مباشرة عندما تنقر على الزر "ضرب".هذا كل ما نستطيع 
عمله الآن.حفظت نسخة من المشروع هذا لك بالدليل الجزئي التابع لمشاريع الفصول في ملف المشروع لهذا الفصل. 


لضرب يتين مع بعضهما أدخليما في حقرل نصبية ومن ثم اثقر على الزر"ضرب". 
operand 1 MissingMiust be integer‏ 
operand 2 MissingMlust be integer‏ 


0 | شرب 


اتصال صفحات آسبي دوت نت إلى قاعدة البيانات»وخاصة إذا كنت تستخدم بعض ميزات نمط المعالج السحري ءارأول 2۲اس للفيجوال 
أستوديو سهل جدآً جدآً.وهذا لأن العديد من الأدوات المضمنة مع آسبي دوت نت تم تصميمها بشكل خاص لعرض التفاعل مع البيانات من 
مصدر بیانات جدولي(مستوي ۲ال طا ). سنختبر(او نضع تحت الاختباراناه ٣۷‏ ) متال معالجح سحري سريع هناءونعمل أكثر من تكامل قاعدة 
البيانات في مقطع مشروع هذا الفصل.في الفصل20ءتعرض التقارير الخمسة الأولى الجاهزة(المبنية داخلياً) التي عملنا على إنشاءها 
لمشروع المكتبة قائمة بجميع البنود المستخرجةأاه- - checked‏ .وصممننا تقریر ٤ا80‏ لھا»وبما أن ASP.NET‏ یتضمن أداة عرض تقریر 


RDLC‏ »نستطیع إعادة استخدامها من أجل تقریر معتمد على وبب. .ولکن بالمقابل سنعرضص التقرير باستخدام واحدة من أدوات ن نماذج ويب» وهي 

viewل‏ اا6 .إليك الاستعلام الذي يستخلص البنود المستخرجة: 
"SELECT PA.LastName + ', ' + PA.FirstName AS PatronName, PA.Barcode AS PatronBarcode, PC. DueDate,‏ 
IC.CopyNumber, IC.Barcode AS ItemBarcode,NI.Title, CMT.FullName AS MediaName FROM Patron AS PA INNER‏ 
TOIN BAEEORCOSY AS BE ON PEAS TID 3S PCE. EAEEGON INNER WON TEENCIONY AS TE ON EC. IEENCOIBY > TC TD INNER TON‏ 
NamedItem AS NI ON IC.ItemID = NI.ID INNER JOIN CodeMediaType AS CMT ON NI.MediaType = CMT.ID‏ 
WEERE (EC .REEUENEed = UOJAND PE. Missing — O0 AND TE MISsSing — 0 ORDER BY NI TIEle, IC. COPYNUMBDEE,‏ 
PA.LastName, PA. FirstName"‏ 


ان هذا يجب أن يبدو مألوفا. .أنشئ موقع ويب لأُسبي دوت نت جدید اأ 6س ASP .N٤۲‏ سهم من خلال الفيجوال أستوديو.اكتب السطر التالي 


عنا أعلى صفحة المحتوى 
ACME Library Checked Out Items‏ 


وأنت حر في تزينها بحيث تبدو أجمل.أنا عملت على تضمين الوسوم<۸1> حولها في الترميز لجعلها قائمة بذاتها.تحت سطر العنوان ذاك.أضف 
أداة س#۷iلنإ6إلى‏ الصفحة.لقد وحدتها في مقطع البيانات aالصندوق‏ أدوات الفيجوال أستوديو ×١0ط١١٠٣‏ الخاص بي. الوسم السريع للأداة 


يفتح وتظهر لوحة من مهمات .6۲|۵۷i۴W‏ كما هو مبين في الشكل التالي. 


ACME Library Checked Out Items 


Column Column1 Column? 


Ato Format... 
Choose Data Source: {Mone} 5 


Edit Zolumns... 
Add New Zolurmn... 


Edit Templates 


_ 
إذا أردت النقر على المهمة "تنسيق le‏ "وتغيير المظهر للشبكة»تستطيع ذلك»ولكن المهمة الهامة حالياً هي اختيار مصدر 
البيانات Choose Data Source‏ .اختر من القائمة <urceهS New‏ dلA>.فيظهر‏ المعالج السحري لتركيب مصدر البيانات»مع بعض التغيرات 
النوعية لأسبي دوت نت.اختر قاعدة البيانات من أجل مصدر البيانات وانقر موافق0K‏ .عندما يطلب منك الاتصال»سيكون لديك سابقاً اتصال 
قاعدة بيانات المكتبة في القائمة.اخترها(أو اعمل على إنشاء اتصال جديد)وانقر التالي×N6‏ . 
سيطلب منك حفظ نص الاتصال في ملف تركيب التطبيق.إذا عملت على الحفظءسيتم إضافة مدخلة إلى مقطع <ءوہا٣†o”Sناcمconn>‏ لملف 
و eb.conس‏ المنشئ لتطبیق ۲٤۸8۴.۸.إذا‏ كنت تريد تشغيل دعم الألعاب مع مدير نظامك» اترك الحقل غير مختار.ولكن إذا كنت تريد طريقة 
سهلة لتعديل معلومات الاتصال فيما بعد.فالأفضل ترك الحقل كما هو(مختار كما هو مبين في الشكل التالي). 


القضل ,لقانت و اتون تين الوت Mhm76‏ 


Configure Data Source - SqlDataSource1 


U Save the Connection String to the Application Configuration File 
و‎ 


Staring connertion strings in the application configuration file simplifies maintenance and deployment. To save 
the connection string in application configuration file, enter a name in the text box and then click Next, IF you 
choose not to do this, the connection string is saved in the page as a property of the data source control, 


Do you want to saye the connection in the application configuration file? 
[¥] Yes, save this connection as: 


حفظ او عدم حففل نص الاتصال 
libraryConnectionString‏ 


| 4 Previous | next>) 


امنح المدخلة اسم مناسب.ومن ثم انقر التالي.يطلب منك المعالج السحري من أجل الجدول وتفاصيل الحقل.اختر"تعين عبارة سكول أو 
الإجراء المخزنء Specify a custom SQL statement or stored مrocedu r‏ ."انقر التاليا×N6‏ »كما هو مبين في الشكل التالي. 


Configure Data Source - SqlDataSource1 کک شا‎ 


u Configure the Select Statement 
[ 


س 


Hoye would you like to retrieve data from your database? 


@) Specify a custom SQL statement or stored procedure 
(O) Specify columns from a table or view 


Previous | [Next> | 1‏ 4 | 
انقر التالي» واكتب عبارة استعلام البند المستخرج(الاستعلام السابق الذي يستخرج البنود المستخرجة) في حقل عبارة سكول اه8 
ement‌tهst‏ كما هو مبین في الشکل التالي. 


اسسا 


Lancel | 


Configure Data Source - SqlDataSource1 


8 Define Custom Statements or Stored Procedures 
[ 
کاک‎ 


Click a tab to create a SQL statement for that operation. 
| SELECT | uppATE | nsenT [ıpeLeTE | 


@ 3L statement: 


SELECT PA,Lastlarme + ', ' + PA, FirstName A5 PatronName,PA, Barcode A5 
PatronBarcode, PZ, DueDate, 1C, CopyNurmber, IC, Barcode A5 ItermnBarcode, NI, Title, 

CMT.FulName A45 Mediallame FRADM Patron A45 Pû INNER. 10IN Patron Copy 45 PC ON PA, ID = 
PC.Patron INNER 10IN ItemCopy û5 IC OM PC, ItemCopy = IC,ID INNER JOIN NamedItermn A5 NI | 
ON IC, ItemID = MI,ID INNER JOIN CodeMediaType AS CMT ON NI. MediaType = CMT ID 


WHERE(PC,Returned = D}jAHD PC. Pissing = O AFD IZ, Missing = O ORDER BY NI, Title, چ‎ 


Query Builder... 


Previous 1 Next | |‏ < ا 


أ Lancel‏ 
انقر التالي مرة أخرى.يعطيك المعالج السحري فرصة أخيرة لاختبار الاستعلام قبل أن تنقر على الزر"إنهاء ء٢۴‏ " كما هو مبين في الشكل 
التالي. 


اقل ,الات راتوو تل الوت Mhm76‏ 


Configure Data Souırce - SqlDataSource1 


IL Test Query 
<| 


To preview the data returned by this data source, click Test Query, To complete this wizard, click Finish, 


PatronName PatronBarcade DueDate Copyumber ItemEarcode Title Mediallamê 


Test Query‏ ا انقر هذا الزر 


SELECT statement: 


| seıEcT Pa, Lastlame +, ' + Pû, FirstName A5 PatranName PA, Barcode û5 PatronBarcode, PC. DueDate, 
| IC.Zopyhlumber, IC, Barcode û5 ItemBarcode, NI, Title, CMT. FullName A5 Mediaame FROM Patron A5 Pû 


والآن هنا الجزء الأبسط. تتصل الفيجوال أستوديو إلى قاعدة البيانات. تقرأً المخطط والأعمدة المنشئة في الشبكة المصممة بإتقان من أجل 
الاستعلام.اكتمل تطبيقك اضغط ۴5 لتشغيل التطبيق.سنتوقف هنا الآن» واحفظ هذا من أجل مشروع المكتبة في مقطع المشروع لهذا الفصل. 


هل حاولت استخراج قطعة من البيانات من موقع ويب لتستخدمه في تطبيق الفيجوال بيسك؟إذا كان الجواب لا؟لذلك دعني أخبرك :إنه "كشط 
الشاشة أو تنظيف screen i e‏ وهو فرعن .معظم مواقع الوب مع و الثمين تم تصمیمها من قبل ناس نانيین. »مبرمجین 
يريدون إضافة قيمة إلى تطبيقاتهم الخاصة لتحسين محتواها من شارك آخر موثوق. 

المحتوى دون أن يتصل بك أولاً وبلا مخاملة .لحسن الحظءيوفر مؤسس اتصال ویندوز e‏ لیذ ا المشكلة .تقنية ا الجوهرية هذه کانت 
سابقآ(في الزمن السابق) كود مسمى0 لال٣‏ | ءيتواجد لنقل البيانات الهامة بين التطبيق والنظام محلي ٥٥۵۱‏ !أو بعيد ه٥٣۲6‏ .يتم اختصار 
مؤسس اتصال ویندوز عادة ک ۴٤۷.یربط‏ عدة تقنیات ممیزة إلی کل موحدھاماس edاfiاہں‏ :طوابیر الرسائل sمuعgu message‏ (متل 
MSM۵)».خادمات‏ ويب(لاحظ الملاحظة القادمة).المداولات الموزعةءہ٠ناعمsہtra distributed‏ (مثل ٥٤5501).و‏ تحکم دوت نت البعید ۴۲× 
Remoting‏ .بما أن كل من هذه التقنيات تتضمن نقل المعلومات من تطبيق لأخر.فكان لايستحق العناء من ميكروسوفت أن تنفق نقودآً أكثر مما 
قد رأيته على الخدمة المدمجة. 

إذا ما کان موقع ما لدیه محتوی أو عمليات تحتاج أن تستخدم من قبل تطبيقات خارجية»فيمكن أن تتضمن "خدمةهءأ6۲۷ء "على الموقع تجعل 
كشط الشاشة غير ضروري.ينفذ ۴٨٤۷مكافئ‏ استدعاءات دالة معتمد على تبادل الأنظمة»يكتمل بالوسيطات والقيم المعادة»وكل ذلك يمكن 
الوصول له عن بعد.وكل هذا يعتمد على معايير النشر مثل برتوكول إمكانية الوصو Jكilئj‏ بط Simple Object Access Protocol (SO©0AP)‏ 
والذي يستخدم نص بسيط و ا۷N×‏ لمحاكاة استدعاء دالة بين نظامين. 


يتم تضمين الكثير من التقنيات في ۴٥۷الجعله‏ ممكن»ولكن عملياً لا تحتاج إلى معرفة هذه التقنيات» بالمقابل»ستنفذ واحدة أو أكثر من طرق 
الفيجوال بيسك المعتمدة على واجهة تحددها أنت.وهذه الواجهة8٤ |١6۲٣‏ »يتم ترميزها بمواصفات ۷°٥۴‏ معينة»تعمل على تأسيس "عقد 
الخدمةأعجإامco‏ مvicاهs‏ "الذي يجعل الاتصال الوظيفي بين نظامين ممكن.تظهر خدمات ۴٥٤۷۷كملفات‏ ء۷ءئ. على موقع الويب الخاص بك.في 
الفيجوال استوديوءتستطيع إما إنشاء موقع ويب جديد مااي امس سه" واختيار خدمة ۴٤۷كنوع‏ مشروعء»او إضافة بند خدمة WCF Service‏ إلى 
مشروع موقع ويب موجود.عندما تعمل ذلك تضيف الفيجوال أستوديو الملفات الضرورية لمشروعك.الاختيار الأول هو ملف ٥۷ئ.‏ حقيقي.فهو قناة 
واجهة سريعة ءءه؟امامi‏ أاaصs‏ بين موقع الويب وكود خدمة الويب الحقيقي.إليك ما وجدته في ملف الخدمة ء۷ئ. الخاص بي. 
ServiceHost Language="VB" Debug="true" Service="Service" CodeBehind="~/App Code/Service.vb" $>‏ @%5< 
تشير هذا التوجيهات إلى مستدعي فنة الخدمة هءءا86في ملف الكود المصدري &6/۷/٥6.۷6‏ المرافق.ذلك الملف هو أكثر أهمية.إليك قسم 
من ذلك الملف: 
Public Class Service‏ 
Implements IService‏ 
Public Sub New ()‏ 
End Sub‏ 
Public Function GetData (ByVal value As Integer) As String Implements IService.GetData‏ 
ReEUEn SEEING. EOEMatE (YOU entered: (OFT, value)‏ 
End EURGEIOR‏ 
Public Function GetDataUsingDataContract (ByVal composite As CompositeType) As CompositeType‏ 
Implements IService.GetDataUsingDataContract‏ 
If composite. BoolValue Then‏ 
COMPOSE Ee. SEI RNGAVa lue > (COMOOS1 Ce. SErIRNGVaALUE € SUEEIxX)‏ 
ENG TE‏ 
Return composite‏ 
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الفصل الثالث والعشرون:تطوير الويب. Mhm76‏ 
Ena FEüne Ei On‏ 
End Class‏ 
يبدو هذا الكود بسيط بالنسبة لي»وستعمل على تبديله عندما تكتب الخدمة الخاصة بك.تنفذ فئة الخدمة ١ءءاه8في‏ الكود أعضاء الواجهة 
مvicاSe|‏ الموجودة في ملف ۴.۷60٥/56/۷/ذو‏ الصلة . 
ESer vee COREEASE OE‏ 
Public Interface IService‏ 
SOPEEA EL ONCONEEa EE OS‏ 
Function GetData (ByVal value As Integer) As String‏ 
SOBEEA EF ONCONIE E ale E>‏ 
Function GetDataUsingDataContract (ByVal composite As CompositeType) As CompositeType‏ 
TODO: Add your service operations here‏ "' 
End IBteri dee 2 ٤‏ 
كما هو مبين» تحتوي الواجهة آيضا عضو ليس له أهمية» 1028ء6 والذي یجب ان یتم تبدیلهء وتم ترمیزه من خلال مlgصغة <OperationConirac>‏ 
المرتكزة على 0۴٥٧ء‏ والتي تصرح»على طول مع مواصفة الواجهة<اءةءامSeviceCo>.‏ "توجد خدمة ۴٤۷هنا"»تذكر‏ ان المواصفة تضيف توصيف 
بيانات إلى مجمع ما لذلك إن المترجم أو بعض البرامج الأخرى ستعمل شيء خاص مع البنود المرمزة .في هذه الحالةء»تخبر ۷٣۴‏ 
المواصفة<اء Cora‏ ationمم0>على‏ الطريقة 610a‏ (عند التنفيذ) كعضو خدمة.يستجيب ۷٤٥۳۴‏ بوصل(ربط) كل كود السبر(الكود المتفحص) 
الذي يجعل الخدمة ممكنة.سأعمل على تبديل الدالة ه6۲0 بواحدة أخرى تدّعي على الأقل عمل شيء ما حقيقي.أولاً. سأعمل على تغير 
الواجهة vie‏ 56ابحيث تعرف |aJlقcontractı‏ . 
OO WICC 2 |_|‏ 
Public Interface IService‏ 
Opera E1 onCGOnierae E OS‏ 
Function NumberToText (ByVal sourceNumber As Integer) As String‏ 
End Interface‏ 
ومن تم في الفئةءءاvهS‏ .سانفذ الواجهة وعضوlk .Number1oT ext‏ 
Public Class Service‏ 
Implements IService‏ 
Public Function NumberToText (ByVal sourceNumber As Integer)‏ 
As String Implements IService.NumberToText‏ 
Select Case sourceNumber‏ 


Case 0 : Return "Zero" 
Case 1 Return "One" 

Case 2 Return "Two" 

Case 3 Return "Three" 
Case 4 Return LESUL 
Case 5 Return "Five" 
Case 6 REtUENn "Six 

Case 7 Return "Seven" 
Case 8 Return "Eight" 
Case 9 : Return "Nine" 


Casêée Else : Return "Out of range" 
End Select 
ENI HURE EIGN 
ERA Class 


إذا شغلت هذا التطبيق في الفيجوال أستوديو سيفتح مستعرض الانترنت مع قسم الصفحة المبينة في الشكل التالي. 
EEE Service Service - Microsoft Internet Explorer 4ã‏ 
ملف لحرير عرض المفضلة أدواتك العلبماك 


© س۰ © ۰ ا @ 2|6 وس @ .ي e‏ 


* اسقال ہنا‎ 9 hitp:##localhost:1031 /WCFS ervicel #Service.swc &]| il ue 


& 


Service Service 


Tou have created ã serrice, 


Ta test this service, Yolu will need to create a client and use it to call the service, Tou can do 
this using the sYeutil,exe tool frorn the csormnmand line with the following syntax: 


SYCULILl: Exe AlED:/7 IOCSIRGST: 10312 WCFSETTICE1: SETTFICE . STEPS 


This will generate a configuration file and a code file that contains the client class. add the 
two files to your client application and use the generated client class to call the Service, For 


Yarn nlm ' 
| 


ل إنترائت محلية 
خدمات ۷٥0۴‏ هي طرق»ومستعرض الويب ليس الوسيلة النموذجية لتشغيل الإجراءات والدوال.لذلك تظهر الصفحة في الشكل السابق بدلاً 
عن ذلك. وهي عبارة عن محتوى إعلامي يبين لك كيف تستطيع اختبار أو استخدام الخدمة»إما من خلال فائدة(منفعة) المصممة لذلك 
الهدف »أو من خلال كود الفيجوال بيسك أو کود سي شارب#٥‏ . 
بما أن هذه الخدمة تعمل على نظامي باستخدام خادم ويب لأسبي دوت نت»سأكتب تطبيق سطح مكتب لاستدعاء الطريقةا×۲۲076٥ط" Nu‏ . 
ابدأً تطبيق جديد منفصل للفيجوال أستوديو وأنشئ مشروع نماذج ويندوز.اختر مشروع ا٥6ز٠۴۲‏ >> إضافة مؤشر(مرجع)خدمة ۸dd Service‏ 
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القصل التالك و العشر ون تطوير الويب. Mhm76‏ 

ference‏ Re.تظهر‏ فورم إضافة مرجع خدمة»إنها أداة تستخدمها لإيجاد خدمات ۴٥۷المحلية‏ وعن بعد. بإمكانك بشكل محدد طلب الخدمة إذا 

كنت تعلم عنوانها.لتحديدهاءانقر نقرآً مزدوجاً على أيقونة خادم تطوير ويب لأسبي دوت نت ASP.NET Development Weۆb S€rv6r‏ في صینیة 

النظام. سيوفر لك الحقل ا8ل R00‏ قاعدة العنوان.على نظامي هو الآن S82"‏ n0s†:1038/۷/eاocaا//:http‏ " على الرغم من آنه وبشکل 

افتراضي سيغير رقم المنفذ إذا ما عدت وشغلت الخدمة.أضف إليه اسم الملف من أجل الخدمة الخاصة بك. 

http://localhost:1038/WCFService2/Service.svc 

أدخل هذا العنوان في حقل عنوان 40۲655 نموذج مرجع الخدمة»وانقر "اذهبه6 ".إذا نجح» تحدد الفورم الخدمة وتعرض عقودها كأعجإcont‏ 

في حقل الخدماتءهء ا56۲۷ .يبين الشكل التالي إيجاد المعامل×١٠١١٠ N.۳۲‏ .تستطيع توفير وصول بالاسم للخدمة في كودك وذلك بتغير 

حقل فضاء الاسمەء2م6s"هھN‏ .ومن نقر الزر موافق)0 . 
ES)‏ 


r. 


Add Service Reference 


To see a list of available services on a specific server, enter a service URL and click 30, To browse for 
available services, click Discover, 


Address: 
wv | a | Discover 
Services; Qperations: 


Service GnumberToText‏ | @ ا 
Service‏ 2 


1 services) Found at address 'http: localhost: 1038WYCTFService2 Service, swr', 


Narnespace: 


ServiceReference 1 


Advanced... 


لوضع الخدمة تحت الاختبار عملت على إضافة أداة صندوق نص ٣٠×۲8٥×‏ وأداة زر ١٥ا8إلى‏ الفورم وأضفت الكود التالي(استخدمت فضاء 
الاسم الافتراضي ServiceRefeِr€£^]›)€1‏ ): 
Eri valze SUS EUSEORL CO EENEYMSL Sender AS SMSEEMS OBNEC E, BuVal E AS SVSEEM  EMENEAEIS) HEnd les‏ 


BUEEONL El ieEk 
MsgBox ( (New ServiceReferencel.ServiceClient) .NumberToText (CInt (Val (TextBoxl1.Text)))) 


End Sub 
شغل البرنامج »اكتب رقم من 0إلى9ءومن ثم انقر الزر.مما يستدعي بشكل صحيح خدمة ويب والعودة بالاسم الإنكليزي لنسخة‎ 
العدد.وستعمل وكان الخدمة ×١٠٠١٠٠١ءط”۳اN١تشتغل على خادم ويب لبحث واحدة من الخدمات البعيد المدى.‎ 
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القضل الرانع والعشين:افافة المسافدة غبر الشبكة. Mhm76‏ 
إضافة المساعدة عبر الشبكة.ضHelp Adding Online‏ 

اكات فاك تيء فلهةه خلال ال25 سنة من البرمخة هة أن الفسفخد مين دانم بحاحة إلى هص المساعدة فشكل نرفجات على 

أنظمتهم. ويحتاج المبرمجين مساعدة أيضاءولكن بالعودة إلى الكمبيوترات:فكان من النادر ما تجد مستخدم خبير.إذا كتبت تطبيقات عمل موجهة 

للعمل والدوائر ضمن منظمات»ستجد أن المستخدمين متقنين لأعمالهم ولکن لیس من الضروري إتقانهم استخدام الكمبيوتر .وهذا لما من 

الملزم عليك صنع برامجحك بسيطة قدر الإمكان. 

وعليك إضافة المساعدة عبر الشبكة لتطبيقات.وهذه المستندات الجاهزة تمثل موجة الدعم الأولى حاجات مستخدمي برمجياتك.وبالطبع ومن 

النادر ما يقرؤونهاءولكن من الجيد أن تكون قادر القول "هل تريد مراجعة المساعدة عبر الشبكة.ءوالتي تفطي هذه القضايا بالتفصيل"'. 

في هذا الفصل»سنناقش خيارات المساعدة عبر الشبكة المتاحة لك في الفيجوال بيسك ونرکز على ×1 ۴٤61p‏ 111 نظام المساعدة لويندوز 

إكس بي ×القياسي . 


لقد أصبحت المساعدة عبر الشبكة جزء من ويندوز بما أنه المحرر الأوليءبالعودة إلى الأيام عندما كانت التطبيقات وأنظمة التشغيل تحافظ عل 
مانويلات كلة«ه«مساعدة مطبوع ولا تحتاج أكثر من قرصي فلوبي.في الحقيقة إني أشتاق لتلك الأيام. كل تلك المانويلات تفيرت واستبدلت 
بأنظمة المساعدة عبر الشبكة وملفات ا1۲۷"اقرأني".فالآن يمكن أن تقرأً كتاب مثل هذا ولكن ستجد الكثير من المساعدة عبر 
الشبكة»وخاصة في هذه الأيام مع القدرة على تضمين صفحات المساعدة عبر الشبكة بشكل ديناميكي(تنتقل تبعاً للموضوع الذي تعرضه) 
والمحتوى الفعال(الشجري الترتيب وغير ذلك من ترتيبات المساعدة الفعالة). 


كان نظام المساعدة الأساسي «[ء71”۸1.وكان يتضمن صفحات مساعدة بتنسيق بسيط مع وصلات صفحات مباشرة من صفحة لأخرى.يضيف 
ملف محتويات منفصل جدول محتويات الدعمءعليك شحن ملف المحتويات ۸1». مع ملف ما۸. كمجموعة .ملفات المساعدة الأساسية هذه 
كانت( ويعدة طرق»هي كذلك)جيدة بشكل كافي من أجل معظم حاجات المستخدمين»وما تزال مدعومة بواسطة جميع إصدارات ويندوز. 
کانت ملفات مe1p‏ ام ۷یتم تصمیمها باستخدام تنسیق نص غني(أو متقدم(۸۲۴) Rich ٣x۲ ۴٥۲۳2۲‏ )»وتنسیق معالج ورد المدعوم من قبل 
العديد من البائعين»ولهذا اليب كان المحتوى سهل البناءء على الرغم من أن وصلات ربط الصفحات والميزات الخاصة بالمساعدة الأخرى 
تتطلب نص ودمج تنسيقات مختلفة»ولكن لاقى ماء 1# احتياجات المستخدمين لسنوات . 


عندما بدا الانترنت يغزو العالم مع مقدرته على إنتاج صفحات بتنسيقات جميلة من خلال لغة اM١#11المعتمدة‏ على الوسوم المعروفة.قررت 
ميكروسوفت تحديث نظام المساعدة الخاص بها إلى نظام يستخدم توثيقات H711 ٨۴]ءامدعاسم:يسايقلا 11M‏ .وکما يدل اسمه ضمنياًء 
مَHe HM1‏ هو حقيقة معتمد على ا11 .أي شيء یولد ا11۷ یمکن أن یولد محتوی م1٥٤ ٧]۲M1‏ :أدوات مصمم صفحات ويب لمشارك 
ثالثي»معالجات وردءإهءءعءهإم 0۲۵س » تطبيقات خاصة بك»وحتى المفكرة. كما تتوقع. بعض الأدوات المصممة من قبل بعض البائعين تكون بشكل 
خاص موجهة لنظام المساعدة .HTML Help‏ 

إن اM‏ #1 آفضل من مpاء W1‏ ءتبعاً لاعتماده على ا11۷ وتقنيات أخرى مناسبة.كل صفحة لملف المساعدة عبر الشبكة هو ملف /إصفحة 
ا Hمنفصلاة.‏ 

وصلات الربط ء«ناإءمرابصفحات مساعدة أخرى هي وصلات ا11۷ مباشرة. و 8»1p‏ اH1M‏ يوظف معظم الميزات المستخدمة في أي 
صفحة ويب« متضمناً صفحات النمط llتسlwلlwية Java scriptinglêl> ğıص gCascading Style Sheets(CSS)‏ . 

ملفات ا11Mالمترحمة(أو‏ المركبة) لديها الامتداد ١۸)..ويتضمن‏ ملف واحد محتوى رئيسي»جدول المحتويات»وفهرس مصطلحات محدد 
مسبقاً. سنستخدم تقنية pاء#‏ 111 لإضافة محتوى المساعدة عبر الشبكة لمشروع المكتبة.وسأترك التفاصيل لما بعد في هذا الفصل. 


معظم التطبيقات التي تم بيعها عند كتابة هذه السطور تستخدم 1pء ۴٤‏ اH1M.ولكن‏ ليس جميعهاءواحد من أكبر الاستثناءات هو الفيجوال 
أُستودیو نفسها.فنظام تعليماتها(أو مساعدتها) یعتمد على 2 1pء1 1ic٥0/‏ (ویعرف أیضاً ×2 HM H8 e1p‏ )وهو جمع أو دمج محتوک HTML‏ 
و اM×إلى‏ مجموعة تجمعات تعمل مع بعضها كواحد.إذا كنت قد نصبت النسخة الكاملة من خادم سكول إء۷إءS 8Q1‏ على نظامك مع 
الفيجوال أستوديوءفكلاهما يتشارك واجهة مساعدة مشتركة.تستطيع حتى البحث عن الصفحات في كلا التجمعين في نفس الوقت. 

تجعل ميكروسوفت "مجموعة تكامJ‏ |لlمlwعةKit Help Integration‏ " متاحة من أجل المطورين الذين يرغبون بدمج محتوى خاص بهم إلى 
نظام 2 1e1p‏ اMicrosof.وهذا‏ أكثر فائدة من أجل البائعين الذين يطورون أدوات مشاركة ثانوية بحيث تتكامل مع الدوت نتE1..‏ أو خادم سكول 
.SQ1 Server‏ ونادرآً ما یتم استخدام 2 م11 ofوهاMiمن‏ أجل برمجيات المستخدم النهائي . 


يستخدم ويندوز فيستا نظام مساعدة جديد يدعى "منصة العمل المساعدة )A۸۴(‏ ١١٥/إه۲1‏ عistuncء".جميع‏ المساعدة عبر الشبكة التي 
تأتي مع الفيستا تم كتابتها باستخدام۸۴ »ولكن ليس بالنسبة للباقي.لأن ميكروسوفت قررت عدم إصدار هيئة الملف من أجل أن يتم 
استخدامه من قبل باقي البائعين. 

حسناً »يوجحد القليل من الشركات الكبيرة و (خ€۸ 0EM )0 fice for emergency "a" 29e‏ تستخدم 4۴.ولكن أنت وأنا لسنا منهم. 


لانشستخدم كل تى اة الحساعة المد من قبل مكزو وة فعضي الط اة لا تكم ساعد سر الك على اغاق 
فدات الذاتهة ب اها قي مخرة استفلال واخدعن ماغات وهي يديل فلل الوه هن أحل النطيقات الفسيطة أو تلك الحفتهافة على 
ا a a‏ ر و اک دم ات وال ال وط فی ال لو ا ها انا 
ملفات مساعدة عبر الشبكة حقيقية. 

توجد ميرة قي الفجوال أستوهو تيح لاف افاج توق من فلات < المفافة لكل عضو قي فك (لن اقنرحها رأ المسافدة غبر الشكة 
الخاصة بالفبجواك أستوذيو ومن أجل المزند هن المغلومات راج فقرة تعلقات < في الفليخات التي تنضها مع الفيجواك استوديو). 

لاتفكر جى باستخد ام هذة الهيرة مى أجل الأوتى الموخه للمتتكتمر أو العليمان الموجمة للمتمتخدم مالم تكن تطور مكوات مهد 
على فئة من أجل أن يتم استخدامها من قبل مطورين آخرين. 
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يتم بناء ملفات 1M]‏ #المساعدة pا8e HM‏ من عدة ملفات مصدرية : 

»ملفات المحتوى ءءاث/ ۸۲1ء۸1٠٤‏ »وخاصة ملفات ا11۷ القياسية»وصل المعلومات الجوهرية للمستخدم »إما من خلال نص ثابت ورسوميات أو 
من خلال سلوكيات(أو تصرفات) نمط صفحة ويب المتقدمة وصيغ متاحة بشكل طبيعي في صفحات ويب. 

.ملف محتويات المساعدة ۸14ء0۸1٤‏ ماع7 الذي يستخدم .۸[۸٥‏ في امتداده .باستخدام وسوم -[#1MNالقياسية<ان>‏ و <ذا>.يحدد الملف جدول 
هرمي(أو شجري) للمحتويات المستخدمة بواسطة ملف المساعدة . 

.يستخدم ملف الكلمات المحجوزة للمساعدة عاث وdهاoسرءK‏ ماع7 امتداد الملف ۸۸۸..ويوثق الفهرس المستخدم للوصول إلى صفحات 
المساعدة من خلال كلمات محجوزة خاصة محددة قاً. 

.ملف مشروع المساعدة.الذي يستخدم امتداد الملف HD‏ .يعرف مشروع المساعدة الكامل وملفه ۸ء. المستهدف.وهذا ملف نصي ذو نمط 
أولي ا×ه) #ار†ء-1N1‏ يعرف جميع الملفات الأخرى التي سيتم تركيبها أو ترحمتها إلى ملف المساعدة المستهدف.ويعرف أيضاً العديد من 
الخيارات الواسعة للمشروع 

تستطيع بناء ملفات المجك الرئيسية يدوياً باستخدام أي أداة ا11۷ قياسية تريد»طالما أن التنسيق الخارج يتطابق مع ماهو متوقع من قبل 
مترجم المساعدة ل ا11M(المزود‏ من قبل ميكروسوفت).بالنسبة لملفات المحتويات»بشكل عام الأداة التي تستخدمها ليست بالقضية 
الهامة بما أن اHMكافي.‏ إن أي وصلات مباشرة ءkہنااءمرطتعمل‏ على تضمينها في المحتوى إلى صفحات مساعدة اخرى في نفس الدليل 
ستصبح وصلات مساعدة قياسية دنا ماءط في ملف المساعدة المترجم أو المركب. 

تتطلب الملفات التي لا تحتوي على محتوى تنسيق بدقة عالية»فجميعها تعتمد على اM١11.ما‏ عدا ملف مشروع المساعدة.والذي هو ملف 
أولي]1N1‏ . ستحتاج إما إلى تصميم هذه الملفات يدوياً أو باستخدام تنسيق متوقع»أو استخدام أداة يمكنها إنتاج هذه الملفات لك في تنسيق 
أو هيئة صحيحة. 

توفر میکروسوفت أداة مجانية تساعدك على إنشاء ملفات بدون محتوىءء]ن؟ أ١م)دoء-0nد‏ مطt‏ »وضمها مع بعضها ومع ملفات المحتوى من أجل 
الترحمة أو التركيب النهائي.تستطيع تنزيل 100ء0۸ ء11 M1‏ 1مباشرة من موقع ميكروسوفت على الويب .اذهب إلى مركز تنزيل 
ميكروسوفت في |لصٍèفة http:/lwww.microsoft.con/downloads:‏ 

وابحث عن )" Help Workshop‏ اH1M‏ "')ستستقبل عدة نتائجولکن الأولى في القائمة(عند الترتيب بالأكثر شعبيةران۲ةاuم‏ همم )ستكون الأداة 
التي تحتاجها.يبين الشكل التالي الصفحة الرئيسية لتطبيق. 


۴ HTML Help Workshop EES 
File Yiew Test Tools Help 


EEE 


في باقي هذا المقطع»سنستخدم ٧ [M1 He1م Workءط ٥p‏ لبناء ملف مساعدة بسيط يحتوي صفحتين:صفحة الترحيب عع2م 0۳۴ء1٠۷‏ و صفحة 
"المزيد من المعلومات ٥٣‏ .]هم1 more‏ ".ساضمن هذا المشروع مع المشروع lلنڑlائيHTMLIHelpSanple‏ . 


يتضمن مشروعنا الصغير ملفي محتوى: ١۸1.ع٠ء1عس‏ و o."‏ إہiءاoص.حتى‏ ولو كانت التقنية متطورة »عملت على صناعتها بالمفكرة.إليك 
محتوى الملف٣we]come.۸1‏ . 
<html>‏ 
<head> <title> ةoدقمo</title> </head>‏ 
<body>‏ 
/أهلاً بك في ملف المساعدة.للمزيد من التعليمات 
.>ail</aر‏ ®ھhref="moreinfo.htm">l <a‏ 
</body>‏ 
</html>‏ 
,ملف المزيد من التعليمات مشابه كتيرآً لهذا 
<html>‏ 
<head> <title/> ةيفlضإ Ğlمgleo<title> </head>‏ 
<body>‏ 
ليس هناك مايقال أكثر من ذلك.مرحباً بك 
.>il</aقر <a href="welcome.htm"> lia‏ 
</body>‏ 
</html>‏ 
باستطاعتك إضافة ملفات صور(متل ملفات PE6[و‏ 61۴)وتربطهھم كما تعمل عادة في صفحة ويب.تأكد من تخزين ملفات الغرافيك(الصور) في 
نفس دليل(او الدليل الفرعي) الملف الرئيسي من اجل سهولة الوصول. 
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القضل الاك والعهش ةن افافة الفساغدة غ الهكة Mhm76‏ 


لنعمل على إنتاج باقي الملفات من خلال M1 Help Workshop‏ H.شغل‏ هذا التطبیق»ومن القائمة ملف ١ا۴>>‏ الأمر جديد سء لإنشاء 
مشروع جديد.باستخدام معالج المشروع السحري»حدد موقع واسم ملف م.الجديد.سأعمل على إنشاء ملف مسمى «۸۸.ءاماكفي نفس 
المجلد حيث يوجد ملفي المحتوى.يحثك المعالج السحري من أجل ملفات عملت على إنشاءها فقا .ضع إشارة صح في الحقJ" HTML‏ 
los" files‏ هو مبين في الشكل التالي.أضف ملفي ا11M‏ في الخطوة التالية واعمل على إكمال المعالج السحري.يتم إنشاء ملف المشروع 
مع مؤشر أو مرجع إلى كل من الملفين اللذين أضفتهم. 

المشروع فارغ نوعاً ماءفلیس لديه حتى عنوان نافذة محددة من أجل ملف المساعدة المترجم.تستطيع وضع العنوان وإعدادات أخرى عامة من 
خلال خيارات المشروع»التي يتم الوصول لها 0 خلال الزر الأعلى على الشريط الشاقولي الذي يظهر بعد أن تنهي المعالج السحري على 
الجهة اليسارية من النافذة الرئيسية.تستطيع أيضاً أن تنقر نقر مزدوج على البند[0۶110N8S]‏ في قائمة تفاصيل المشروع.عندما تظهر نافذة 
الخيارات»ادخل "مساعدة بسيطةماء۲1 مامص1؟ " في حقل العنوانء])٣‏ .وانقر موافق 0. 


New Project — Existing Files 


Ifyou have already created files that you want 
to include in your project, specify them below: 


FT HTML Help table of contents [hhc] 
FT HTML Help index (.hhk] 
IW HTML files [.htrm] 


Back Cancel |‏ 4 
أما ما يحويه ملف المشروع مبين في الشكل التالي: 


û” HIML Help Workshop 
File Yiew Test Tools Help 


ااك اعات إعاد 


roject | Contents | Index | 


| [OPTIONST 


Compatibility=1.1 or later 


Compiled file=Simple.chrn‏ چ 
Default topic=moreinfo. htm‏ 
a Display compile progress=No‏ 


F Language=Ûx403 English [United States] 
[FILES] 
8| moreinfo.htrn 


Welcome. htm 
3 
E 


ر اتب إالكتب المترجحمةاكتاب برمجة تيم E:\learningcomputer {PROGRAMING Lû4NGU1GE1Y8. NET +b nek dui‏ 
سيتفير الملف كلما أضفنا ملفين بدون محتويات ءعان؟ ا١م†«هء-«0د w0‏ آخرين» ولكن ليس كثيرآً.ترجم الملف الآن(باستخدام القائمة ملف مان۴ 
>> الأمر ترخم #اتوصوت) وتشفيلة هررض تافذة مساعدة بستطة »كا هو ميين في الشكل التالي. 


سيساعد جدول المحتويات المستخدم في قراءة واختبار المساعدة الضخمة عبر الشبكة .لإضافة ملف المحتويات»انقر على تبويب المحتويات 
على الجهة اليسارية كامعا«ه من الفورم الرئيسية»ورد على الطلب الذي ترغب به لإنشاء ملف جديد» سمه ٥۸۸.ءام51.تتفير‏ الفورم لعرض 
محرر جدول المحتويات. توجد طريقة أخرى لإنشاء ملف المحتويات هو باستخدام القائمة ملف eا۴>>‏ الأمر جدید ٤W‏ واختر جدول جدول 
المحتویات ءادءا«ه ٤ه‏ ماطه1 من نموذج الاختيار الجديد. وهذا أقل دليل»وكما أنه لا يرتبط مباشرة بملف المحتويات بالمشروع. 


استخدم أزرار شريط الأدوات الجديد للتنقل للأعلى أو للأسفل أو اليسار أو اليمين لأضافة وتعديل مدخلات المحتوى»استخدم الز ر العلوي( 
"خاصیات المحتویاتءe۲):eم۴r0 Contents‏ ")لتحریر خیارات جدول المحتويات .في نموذج خاصيات المحتويات»أزل علامة الاختيار عن 

الحقل"استخدم مجلدات بدل الکتبءkمهط Use odes instead of‏ " وانقر موافق ˆ0 . 

الأزرار التالية - أزرار الكتاب("أدخل رأسعمہنلةءط ۾ ٤6۲موم‏ ") و زر علامة الاستفهام/الصفحة("أدخل صفحةععهم ه ۲۲ء1 ")-هي الأزرار الرئيسية 
المستخدمة لإضافة مدخلات جديدة إلى المحتويات.قمت بالنقر على الزر" أدخل صفحةءعهم د ۲۲مءد] " للحصول على جدول نموذج مدخلة 
المحتويات المبين في الشكل التالي: 


الفصل الرابع والعشرين:إضافة المساعدة عبر الشبكة. Mhm76‏ 


Table of Contents Entry 


General | Advanced | 


Entry title: Awailable information types: 


welcome 
Add Edit Remove 


Files/ URLs and their information types: 


URL:‏ س ل 
_AdEdt. |‏ 


[|_0 | Cra 

كما هو مبين في الشكل»عملت على وضع عنوان المدخلة إلى(عءصهء1ء۷)»ءواخترت كما هو مبين في الشكل الملف(1۸[.٤1٠٥0ء[ءس)‏ من خلال 
الزر "إضافة ۸٩‏ " .وسأعمل المثل بالنسبة للملف " moreinfo.hm‏ "»وسأعطيه llعgi|ن‏ " More Information‏ ".عملت آيضا على إضافة مدخلة 
رأس باستخدام زر شريط الأدوات"أدخل رأسعم ه٥1‏ ۾ sert‏ "على الفورم الرئيسي»سمیته"صفحات أخری؛ءءعه۴ 6۲ط)0 ".استخدمت أزرار 

أسهم شريط الأدوات لنقل المدخلة١”۲٠.‏ ,1ء١٥‏ إلى مقطع الرس هذا. _ 


Project Contents | Index ۱ 


2 Not much more to say. For a greeting, 
= Û Other Pages Hêk hëFê 
[A] mareinta 


يتيح ملف الفهرس للمستخدم من الوصول إلى صفحات معينة بالبحث عن فكرة أو موضوع من قائمة.توجد علاقة عديد - إلى - العديد بين هذه 

الكلمات المفتاحية وصفحات المساعدة:يمكن أن تقود كلمة رئيسية واحدة إلى صفحة أو أكثر»وصفحة واحدة يمكن أن تستهدف عدة كلمات 

مفتاحية. 

اعمل على إنشاء فهرس بالنقر على تبويب الفهرس ×ءك«اعلى النصف اليساري من الفورم الرئيسي»وتابع طلب إنشاء ملف فهرس 

جدید» سمه ۸۸k).‏ .عeاSinp.‏ کما مع محرر المحتويات»يتضمن محرر الفهرس 1ndexاشريط‏ أدوات ن شاقولي صغير. 

استخدم الزر الثاني في شريط الأدوات»الزر الذي عليه صورة أو أيقونة المفتاح.لإنشاء مدخلات الكلمات الرئيسية»سأعمل على إضافة الكلمات 

المفتاحية: 

.أوليءنيةط » ترتبط بالملف¬اط.welcone‏ . 

.moreinfo.htm فڻaJlب .ترتبط‎ av anc ءdمدقتم.‎ 

.كل شيءعہنطارإءںء ءترتبط إلى كلا الصفحتين. 

نموذج قجوږ مدخلة الفهرس تماما مثل جدول نموذج مدخلة المحتويات. بالسماح لك بتحديد الصفحات الهدف من أجل كل كلمة مفتاحية. 
ترحم | مما یضیف میزات الف إلى ملف المساعدة المترجم. 


الفصل الرابع والعشرين:إضافة المساعدة عبر الشبكة. Mhm76‏ 
على نظامي»تشغيل ملف المساعدة المترجم يعرض المحتوى في نافذة صغيرة في الزاوية العلوية اليسارية من الشاشة.ولكن محتوى 
المساعدة هام وأريده أن يظهر أقرب إلى وسط الشاشة»وفي نافذة أكبر. لحسن الحظءتستطيع التحكم بالنوافذ المستخدمة لعرض المحتوى. 
إرجع إلى تبويب المشروع اءءزهإ۴وانقر على الزر الثالث على شريط الأدوات الشاقولي اليساري من النافذة.يتيح لك هذا الزر"إضف/عدل 
تحديدات النافذة كصەنانمنگەd window‏ odifyص/A‏ " تحديد واحد أو أكثر من النوافذ لأن يتم استخدامها من أجل صفحات المساعدة المختلفة 
في ملفك.عندما يطلب منك إضافة نافذة جديدةö SimpleWindow" pwۈlJl (iS| New Window‏ ". 
جور أنواع النوافذ الذي يظهر يتضمن عدة خيارات للحصول على النافذة الدقيقة التي تريدها»على الرغم من ومن المحتمل أنك ستكون حريص 
جداً .لنقول أن لديك 243 أنواع نافذة مختلفة.التبويب «٥نازوه۴هو‏ الأكثر أهمية. فهو يتضمن زر التحجيم التلفائي ١1zeوهاسA‏ والذي يتيح لك 
سحب النافذة إلى الحجم المرغوب .تعديل الحجم إلى شيء تحدده.» أضف إلى"نص شريط العنوانا×ع) إوط 1)1٥‏ " النص التالي" مام مامصSi‏ " 
على التبويب CE‏ »ومن ٿم انقر موافق 0۸.بما أن هذه النافذة هي النافذة الوحيدة التي حددناهاء فإنها ستصبح النافذة 

ا ص المساعدة الرئيسية في المرة التالية بعد ان تعمل على ترجمة وتشغيل الملف. 


توفر الفیجوال استوديو طريقتين رئيسيتين لتكامل المساعدة عبر الشبكة إلى تطبيق سطح المكتب .الأولى تستخدم HelpProviderölÎJl‏ »وتوجد 
في مقطع المكونات كا١ء«هم‏ ه٤‏ من شريط أدوات الفيجوال أستوديو .الثانية تستخدم الطريقة "أظهر المساعدةماء۴هطp.8اء8‏ " لحزمة نماذج 
ويندوز. كلا الطريقتين تتيحان لك عرض صفحات معينة أو أجزاء ملف المساعدة ل ا1MN١53‏ المترجم . 


يمكن أن يتم إضافة الأداة ۲٠٠:«هإم[ء1!إلى‏ الفورم لتمكين الوصول إلى المساعدة عبر الشبكة.وهي توفر اختبار أولي للمساعدة عبر 
الشبكة:(1) وصول معياري إلى ملفات المساعدة ا٧11‏ المترجمة (2) والمساعدة المنبثقة(أو مساعد الظهور الفوري «1ءط من-مم).كلا 
الطريقتين تضعان التركيز على أدوات مستقلة للفورموعلى ميزات مساعدة خاصة لكي يتم ريطها إلى كل أداة . 

لاستخدام اداة goHelpProvider‏ ملفات ا#1Mالمساعدة‏ المترجمة »ضع خاصية الأداة aJ !HelpNamespace‏ موقع ملف المساعدة الصحيح.ومن 
تم اضبط خاصیات الأداة الأخرى على الفورم لتشير إلى ميزات معينة ضمن ملف المساعدة.تؤثر الأداة Help Provider‏ بالا دوات ن الأخر بإاضافة 
العديد من الخاصيات الأخرى الإضافية إلى كل منها. .يبين الشكل التالي الخاصيات الأربع |lلإضlفيuة «HelpString «HelpNavigator «HelpKeyword)‏ 
Sh0wHe1p)التي‏ تم إضافتها بشكل تلقائي إلى أداة lلزر .Button‏ 


Properties » MI 


Buttaon1 54sterm, Windows, Forms, Button ج‎ 


HelpEEywmword on HelpProYyider 1 

Helpavigator on HelpProawider 1 ûssociateIndex 
HelpString on HelpProyider 1 

ShowHelp on HelpProwider 1 False 


1 
اة وة المخافة الى كل اذاة هرف رات ملف المساغدة لإمكاتة الهول لها غندما بخفط الفشخدم على الحفاح انها 
تکون تلك الأداة قيد التفعيل.للوصول إلى صفحة معينة ضمن ملف المساعدة(مثل ١۸1.ء٠٠ء1ءس).تضع‏ الخاصية öls JHelpNavigator‏ الهدف إلى 
pic‏ 1وتضع الخاصية GlHelpKeyword‏ الصلة إلى اسم ملف lلصaفة (welcome.htm)‏ 
الكاضة ف ةة من أك أغاة فا يكن أن تم يكوا لأمكانة الوضول إلى ماظع غر الخغهة لعاف الم اة عر الشكة آنا عرش 
القيمة sا«ع†«o٣0۴ءاab"محتويات‏ ملف عبر الشبكة.الفهرس ×ءع«,1يقفز إلى فهرس الكلمة المفتاحية×ءلہ1 ١إه‏ سرع .توجد العديد من الخيارات 
الأخرى أيضا. 
تھکن 8 2 IOEITWTETETT‏ المنكةة وتوم "على 1 افا الت هى الما و لى كوو ةة 
تله اداه فة 5 قوق باك 5ة هاا عارك رسال فكي قوفن مكلفقات الافخخذام غلك الأداف كما قو ممن قي الكل الالي. 


TET ٤ 
إلى الناعبة الرتبسية‎ 


تعمل المساعدة المنبثقة عندما تعمل على تمكين "زر الإنبتاق "في شريط عنوان الفورم.لإعداد المساعدة المنبثقة لإداة ماءاتبع التالي: 
1.أضف أداة He1pProviderإلى‏ الفورم ولكن لاتتعب نفسك بإعداد الخاصية ءءهمءء”Na×ماء8‏ إلى ملف ما. 

2. ضع خاصية الفورم 8u t))٥١0‏ م81 إلى صواب .True‏ 

.False İطþخ‎ aJ |MinimizeBox gMaximizeBox ۾رgفألl ضع خاصيات‎ .3 

4.ضع الخاصية HelpString‏ على HelpProvider1‏ إلى نص معلومات(کما کتبت أا في الزر في الشكل العلوي)على كل أداة والتي ستعرض 
المساعدة الفورية أو المنبثقة الخاصة بها. 

يعرض المستخدم المساعدة الفورية أو المنبثقة بالنقر أولاً على زر"المساعدة "ذو علامة الاستفهام في شريط عنوان الفورم ومن ثم انقر على 
الأداة (كما هو مبين في الشكل العلوي عند النقر على الزر "موافق"). 


الفصل الرابع والعشرين:إضافة المساعدة عبر الشبكة. Mhm76‏ 
تعرض l|لطرıيقة System. Windows.Forms.Help.Show Help‏ أجزاء معينة من ملف المساعدة ا۲۷ 1المترجم بالاعتماد على المعاملات النسبية 
الممررة إلى الطريقة.وهي مشابهة تماما لجزء المساعدة المعتمد على ملف لأداة إملزه٠٣ماء1»‏ ولكن ضمن طريقة تابعة للفورم.لعرض صفحة 
معينة ضمن ملف مساعدة ماءاستخدم هذا التركيب التالي: 
Windows. Forms.Help.ShowHelp (Me, "Simple.chm", HelpNavigator.Topic, "moreinfo. htm")‏ 
المعامل النسبي الأول هو المرجع أو المؤشر إلى الفورم التي تستدعي الطريقة.الطريقة الشائعة لاستخدام هذه الطريقة هي لعرض الفورم 
من أجل المفتاح۴1 .واستدعاء الطريقة pاء ٤‏ 0wط؟من‏ معالجح حدٿث الأورم۾ .KeyDown‏ 
EE vakê SUNS OEM KeVDONNNEVUSL Senders AS OBESE, BYU E KS SMSO MRICS. OEMS KEVE VENE OSD‏ 
Handles Me .KeyDown‏ 
E oS IY E CN ١‏ 
If (e.KeyCode = Keys.Fl) Then‏ 
Windows. Forms.Help.ShowHelp (Me, "Simple.chm", HelpNavigator.Topic, "moreinfo.htm")‏ 
ENG JÊ‏ 
End Sub‏ 
وكما تعلم يجب عليك وضع خاصية الفورم KeyPreview|لى‏ صواب 1۲۲ueلإطلاق‏ الحدث «wه۲طرء×‏ على مستویى الفورم.وإلاءفجميع المفاتيیح 
تذهب إلى الأداة الفعالة وتتجاهل الأحداث على مستوى الفورم. 
توفر الطريقة 1ء۷8٥1‏ الكثير من الأدوات الأخرى لتجرية المستخدم من أجل مساعدة المستخدم عبر الشبكة ويما أنك أنت(وليست الأداة 
)He1pProvider‏ تحدد متى يمكن الوصول إلى ملف المساعدة. 


حالما تتمكن من الوصول إلى ملف المساعدة عبر الشبكة»فإنك تتمكن من الوصول إلى كل صفحة فيه.وهذا شيء جيد.لأن المستخدمين 
فضوليين.ولكن في حالة مشروع المكتبة»يمكن أن يقود الفضول إلى مواضيع لا علاقة لها بالزيائن العاديين.معظم الميزات في تطبيق المكتبة 
e‏ استخدام المستخدم الإداري.لحفظ الأشياء هادئة قدر الإمكان»يتضمن مشروع المكتبة ملفي مساعدة عبر الشبكة: 
. ibraryBasic.chmا‏ ملف المساعدة الذي يستهدف المستخدم والذي يشرح فقط أجزاء البرنامج التي يمكن للمستخدم الوصول لها. 
. Admin.chmرrarطLi.‏ ملف يستهدف الإداريين وأمناء المكتبة والذي يشرح كامل ميزات التطبيق. 
هذا المقطع يبني ملفات المساعدة عبر الشبكة هذه»و يكا مع تطبيق المكتبة. 


عملت على كتابة كلا الملفين من أجل ملفات المساعدة عبر الشبكة من أجلك.ستجدها في الدليل ماء11 ٠۸ا0۸‏ ويتضمن التفرعين من أجل 
الملف والملف .يبين الشكل التالي قائمة بالملفات الموجودة في الدليل. 


Patrornûccess | MainForm_Basic 1 LibraryB asic il Lhangellzer 31 
PatronPaszsword 3 MainForrn_H ۳2ء‎ LibraryB aziz "™* CheckLonkup_O ut 3 
PatronR ecard 3 M ainF ormn_Library €] LibraryB اة‎ 
Welcome 3 MainForm_U ur] LacateDatabasze 3 ltemLaokup 3 

MainF orm_Patran i] LocateLicerze&] 


ملف المساعدة الخاص بالزيون. 
Namedltem ê] Librarpêdmin 5 LheckLookup_U ut] 2uthar #8‏ 
Patron &] Librarmêdrmin "* Codeêıthorî ype] AuthoraddLorate #&]‏ 
Patronêccess#&] Librarpê,drnirı 2 CadeCopyStatus 4#] A,uthorLirnit 1‏ 
PatronLinit 4] ListE ditR ecards 3 CodeLocatiorn 4#] BarcodeLabel 3‏ 
PatronPassword ®] Locatel atabaze 3 LodeM ediaT ype] BarcodePage 3‏ 
PatrornPaymenté®] LocateLicense 3 CodePatronGroup | BarcodePrint 3‏ 
PatronR ecard i] MainForm_ûdmin #2 Lode5 aries] BarcodeT oalB arcade 3‏ 
ج 3 Publisher] MainForrmm_Basic 3 Copyriaht ê] BarcodeT oalD aleke‏ 
Publisher4ddLocate 4#] MainForm_Û ally 3 Group ane &] BarcodeT ool own 3‏ 
PublisherLimité&] MainForm_Help 3 H oliday é&] BarcodeT oalLine =)‏ 
Reports elect #] MainFoarm_ln 3 lterméuıthorE dit] BarcodeT ool umber =)‏ 
eriesê4ddLncate &] MainForm_Library #2 ItemCopy i] BarcodeT oolR ect 3‏ 5 
Subjectê,dd 3 MainForm_Uut 2 IternLirmnitê#] BarcodeT oolT ext =‏ 
System alue&] MainForm_Patron 3 ItemLonkuup #&] BarcodeT anlllp =)‏ 
User amet] MainForrm_Print 3 Kepwordêdd 4] Changellser 3‏ 
welcome ê] Maintenance 3 Libraryêdmin LCheckLookup_ln 3‏ 


ملف المساعدة الخاص نالمشستخدمين الإداريين وأاهناء المكة: 
معظم ملفات ا11۷Nلديها‏ وصلة واحد - إلى - واحد مع نماذج مختلفة في التطبيق.على سبيل المثال. يحتوي الملف٣k۸up.۸1٥0٥1”ء]‏ محتوى 
المساعدة عبر الشبكة من اجل الفورم ط۷.م» 00۸١ء[‏ في التطبيق.وتظهر هذه الصفحة في كل من ملفي إصداري الإداريين والزبائن .عندما 
يضغط المستخدم على المفتاح ۴1من فورم البحث عن بند»يحاول التطبيق إظهار صفحة المساعدة عبر الشبكة٣.0)up.۸1ه1”ء)]‏ .إذا كان 
المستخدم مستخدم قياسي.»فإانه يصل إلى الصفحة في الملف ٣١ء.ءiء»8ر۲ي١ط11‏ . يصل المستخدمين الإداريين إلى نفس اسم 
الصفحة«ولكن من المlلأفLibraryAdmin.chm‏ . 


ألغوا الاك الو كاف اة غي اة Mhm76‏ 
أيضآً عدة ملفات صور بتنسیق جيف 61۴. 
فلت لى جه ل مات رذعت سه فى افو كي فةا الل 


لحفظ الأشياء بسيطة ومركزية نوعاً ماءسنعمل على توظيف الطريقة ماء8«ه1ءالتي شرحناها سابقاً لعرض المساعدة عبر الشبكة من أجل 
كل فورم في التطبيق. عملت جميع التغيرات الضرورية وأضفت الكود من أجلك راجع المشروع. 
وسأعمل على تقدیم کل فورم فيما پلي. 
الفورم توفر سابقا طريقة للمدير من أجل تعين موضع كل ملف مساعدة عبر الشبكة.فهي تحدث إعدادين من خلال الكائن وعدناامS؟.رM.‏ 
My.Settings.HelpFile = Trim (RecordBasicHelp. Text)‏ 
My.Settings.HelpFileAdmin = Trim (RecordAdminHelp. Text)‏ 
وهذين الإعداديين تم تخزينهما في متغيرين في متغيرين شاملين. 
MainHelpFile = RecordBasicHelp. Text‏ 
MainAdminHelpFile = RecordAdminHelp. Text‏ 
تلك الوسيلة الوحيدة التي نحتاجها لاستدعاء ما8 سهط؟من كل فورم والوصول إلى واحد من الملفين متى ما ضغط المستخدم على المفتاح 
.F1‏ 
ولكن ماذا بخصوص لو لم يستخدم المدير الفورمط۷.ء٥‏ 4۸٠ء111‏ لتركيب مواقع ملفات المساعدة؟بما أن ملفات المساعدة ومن المحتمل 
سيتم تنزيلها في نفس المجلد لملف البرنامجء×ء.ر4١ط11‏ .سنجدها هناك بشكل تلقائي. تعمل الطريقة صعاءر؟ءzاهن)¡ر1آفي‏ الوحدة | لبرمجية 
ط.aاعnعG‏ مسبقاً على وضع متغيرين عامين إلى قيم مخزنة في الإعدادات. 
ا ولف ااا اة ع ا E‏ 
MainHelpFile = My.Settings.HelpFile & ""‏ 
MainAdminHelpFile = My.Settings.HelpFileAdmin & ""‏ 
فقط في حال كانت هذه الإعدادات غير موجودة.لنضيف بعض الكود بعد هذين السطرين لتوفير الوصول الافتراضي إلى الملفات. 


TE MainHeleni le E SD Then MainHelDEI le My. COMSUEEE Bil eos Etem. COMONRERAER 
MMI ABEL E SEO EME O DI EOE EOE MEGER, CM DEAE YEAS EE CRM) 
TE Mam Rams mel gE e SD Then Mai DAGMINHE LES le SS My COMSUEEE E E ESS EER CONSIDERS 


My. Application. INREO. DI rECEOEYVESEN, MBEaE VAAMIR. CML) 
بما أننا بحاجة لتكييف حالة التطبيق بالنسبة للمستخدم الحالي بشكل مستمر (فيما إذا كان المستخدم زبون أو مدير)»فروتين مركزي والذي‎ 
يعرض المساعدة من الملف الصحيح سيبدو أفضل.إليك الكود من أجل المساعدة عبر الشبكة»وهي طريقة جديدة في الوحدة البرمجحية‎ 
. General.vb 
Public Sub OnlineHelp (ByVal whichForm As System.Windows.Forms.Form, ByVal contextName As String) 
ااطوار اسسا عة عر اة اال ر ن اس اح ااا ع‎ 1 
ال ا دا ا ا ا ا‎ 
Dim fileToUse As Sizing 
أي ملف سيتم استخدامه‎ 
Tf (LoggedInUserID = -1) Then 
fileToUse = MainHelpFile 


Else 

fileToUse = MainAdminHelpFile 
Em TE 
If (fileToUse = "") Then 


MsgBox E O OS AN GE CSN SSS CE MSGEOXS ENE OKEY GE 
MsgBoxStyle. Exclamation, 


ProgramTitle) 
Re UE 

Emad Tf 

ا کر ا 

Ey 
Help.ShowHelp (whichForm, fileToUse, 
HelpNavigator. Topic, contextName) 

Ca tel 
MSGEOS CEE CE EE EVET E E 
ON Ee LCN gE SONE, MsgBoxstEyle, OkOnly OE 
MsgBoxStyle.Exclamation, ProgramTitle) 

End TEY 

End Sub 


المهمة الاأكبر في هذا الفصل تتضمن الذهاب إلى كل فورم في المشروع وعمل كل من هذين التغيرين: 
.وضع خاصية الفورم ey۴۲ ev1ew‏ إلى صواب .True‏ 
.إضافة استدعاء إلى مe1pءne8‏ :ا0 من معالج حدث الفورم ,Key00w‏ 
إليك الكود المضاف إلى الفورم ط۲.۷ءءلاeءChang:‏ 
Private Sub ChangeUser KeyDown (ByVal sender As Object, ByVal e As System.Windows.Forms.KeyEventArgs)‏ 
Handles Me.KeyDown 5‏ 
1 إف1 لاظهار المشاعلاة عر االشتحة 
If (e.KeyCode = Keys.Fl) Then‏ 
OnlineHelp (Me, "changeUser.htm")‏ 
End Sub‏ 
العديد من النماذج تعالج متطلبات المساعدة عبر الشبكة بشكل مختلف قليلاً عن بعضها الآخر. 
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Mhm76 الفصل الرابع والعشرين:إضافة المساعدة عبر الشبكة.‎ 
Wee. فالفورم ط٫.011ط4لاتحتوي صفحة مساعدة عبر الشبكة خاصة بهاءبالمقابل»فهي تعرض.7‎ 
والفورم ط«.۸ء»ار؟لاتحتوي اي مساعدة بما ان المستخدم ليس من المفروض التفاعل معها.‎ 
تلك الفورم التي تظهر كل من التقارير الخمس الجاهزة. تعرض المساعدة من اجل الفورم المناسبة بواسطة‎ ReporrBui]tI]n Viewer. vb الفورم‎ 
. ReportSelect.htm 
للفورم ط۸100۸1p.۷ءء۸٤ صفحتي مساعدة عبر الشبكة:واحدة من أجل البنود المستعارة وأخرى من أجل البنود المعادة.‎ 
ومعالج حدتها «سه20رءKيختار الصفحة الصحيحة بالاعتماد على النمط الحالي من الفورم:‎ 
If (e.KeyCode = Keys.F1) Then 
If (CheckInMode = True) Then 
On lineHelpg Me, EheckKEOOKUD In. BEML) 
Else 
End Lf 
ERO TÊ 
الفورم الرئيسية مشابهة لكل فورم منفصلة»لذلك عملت على إضافة صفحة المساعدة لكل لوحة.يعمل معالج حدث الفورم على إظهار الصفحة‎ 
الصحيحة بالاعتماد على اللوحة المعروضة الحالية.‎ 
If (PanelLibraryItem.Visible = True) Then 
On laneHelp (Me, MainEorm DEAE: HEM.) 
Elself (PanelPatronRecord.Visible = True) Then 
On lameHelp (Mey MainEOrM Ea EON MEM) 
Elself (PanelHelp.Visible = True) Then 
Onl anmelel gp (Mle, MainEorm Hel MEM) 
Elself (PanelCheckOut.Visible = True) Then 
On laneHel o (Me, Maint OUEC MEM. ) 
Elself (PanelCheckIn.Visible = True) Then 
OnlaneHelp (Mey, Mainlorm TR. HEM.) 
ElseIf (PanelAdmin.Visible = True) Then 
On laneHelp (Me, 'MainEorm Admin. REM) 
Elself (PanelProcess.Visible = True) Then 
On lneHelp (Mey, Mata Rorm Dally REM) 
Elself (PanelReports.Visible = True) Then 
On lanmeHe le (Mey, [MaiREOEM Erne BEML) 
Else 


On lineHel gp (Me, Main EOEm Basle HEM) 
e 
لوحة المساعدة(او التعليماتماء8# ) على الفورم الرئيسية تتضمن ازرار مصممة للقفز إلى جدول المحتويات ءا١عادهء وفهرس ×عل,ذملف‎ 
المساعدة عبر الشبكة الحالي.عملت على إضافة معالجات الحدث من أجل هذه الأزرار.‎ 
مشابه تماما للكود في الروتين 1۵81ا 0الشامل»ما‎ MainForm.ActHelpIndex_Click و‎ MainForm.ActHelpContents_Click ja JÛ Jجا الكود من‎ 
عدا الاستدعاء النهائي للطريقة ما 8سهط؟.‎ 
EE iva ee SUMS AEeENlE I OCONEENIES CNEENEYVUSL Sender AS OB Ecer, EvVUal E AS SVS COMIEVERNEATEIS) Hoendles 
ActHelpContents.Click 
N E AN A OEE E 1 
Dim fileToUse As String 
NE CC AN COE 1 
If (LoggedInUserID = -1) Then 
fileToUse = MainHelpFile 


Else 

fileToUse = MainAdminHelpFile 
ENG TE 
If (fileToUse = "") Then 


MsGBOox Online Mele is ROE PEOPEE IY CORE taUEed. 7l 
MSGBOxXSEYI e. OKORn IY Or MsgBoxSstyle. Exclamation, PEOGLamIi Ele) 
Return 
Ena TE 


1 اظهار المساجدة عر الشنكة 
TE‏ 
Help.ShowHelp (Me, fileToUse, HelpNavigator. TableOfContents)‏ 
Cale‏ 
MSsGBOX (LAN error OCCUrEred while trying tO access € &‏ 
ehe online Melg Eile. , MSGEOXS Ele. OEORIY OE U‏ 
MsgBoxStyle.Exclamation, ProgramTitle)‏ 
End TEY‏ 
End Sub‏ 
Private Sub ActHelpIndex Click (ByVal sender As Object, ByVal e As System.EventArgs) Handles |‏ 
ActHelpIndex.Click‏ 
اا ا ا ا ا ا 
Dim fileToUse As String‏ 


I 6‏ تم الول اا 


القضل آلا الى اة المساغدة عى القكة Mhm76‏ 


حالما تكون ملفات المساعدة («1ء.) في مكانهاء وحالما يتم تركيب التطبيق بشكل مناسب لإيجاد هذه الملفات على محطة العمل(أو الشبكة 
المحلية )ءبإمكان المستخدم الوصول للمساعدة من أي فورم بالضغط على المفتاح ۴1. 


القضل الا لفن٠‏ افاقة المسافدة غي الفكة Mhm76‏ 
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الفصل الخامس والعشرون:النشر أو التوزيع. Mhm76‏ 


lلiنشر)Îو‏ llتıjgع(.Deployment‏ 
تتضمن الفيجوال أستوديو خيارات مختلفة تتيح لك تنصيب تطبيقاتك المترجمة ودعم الملفات على الجهاز الهدف.سنلقي نظرة على هذه 
الطرق في هذا الفصل»ونستخدم واحدة من الطرق لبناء برنامح"التثبيت" من أجل مشروع المكتبة. 


قي الأيام التي سبقت میکروسوفت ویندوز»لم یکن التوزيع صعب جداً .فالعدید من البرامج لم تكن اکثر من ملف تنفيذي لمیکروسوفت دوس 
ge «MS-DOS‏ واحد أو اثنين من الدعم للبيانات وملفات المساعدة.هكذا كان الأمر.حالما ما تنسخ هذه الملفات ضمن مجلد ما على جهاز 
العميل وتخدث متغير بيئة المسار۴۸۲۳۸ »سيكون الأمر قد انتھی. 

تطبیقات ویندوز(وبرامج ميكروسوفت دوس الكبيرة والمعقدة)لم تكن سهلة التنصيب.فغالباً کان لديها أشياء ملف اا0 متعلقة بها-ملفات يجب 
أن يتم وضعها في أماكن مناسبة.وفي بعض الأحيان لاتعرف ما هو ذلك المكان المناسب»بما أنه من الممكن أن يكون بائ آخر(أو مشارك 
غریب)قد زود اا0 بدون توثیق کافي.ومن ثم كانت ملفات التركيب(أو الإعدادءماا؟ configuration‏ )»التي تدعم ملفات البيانات.وتغيرات خاصة 
بالجهاز والمستخدم لمسجل النظامرء!ءاوه؟ ۳ءاءرء .الاختصارات على سطح المكتب وقائمة إبداءوالبرامج وإعدادات إزالة التنصيب»مجموعتين 
من نماذج مكتتبة الكونفغرس(في تلاث نسخ أصلية) »ملفات المساعدة عبر الشبكة»ملفات الترخيص واقرأني من أجل النشر على السيديات» 
الخطوط الخاصة والتي يمكن أن تکون مطلوبة من أجل البرنامج»وأكثر وهكذا...إلخ. 

لحسن الحظ»ستشاركك الفيجوال أستوديو العبء بشکل تبادلي من أجل تسهيل التركيب عليك. 

توفر لك ميزات النشر في الفيجوال أستوديو التخصص الوظيفي الأساسي الذي تحتاجه لنشر تطبيقات معتمدة علي ويب والمعتمدة على 
تطبيقات سطح المكتب القياسية.إذا كانت احتياجات التوزيع الخاصة بك معقدة»تستطيع أيضاً شراء مشارك إضافي أداة"التثبيت والنشر م561 
and deployment‏ " والتي تتضمن ميزات إضافية مثل دعم الصيغ(الإنشاءوہ :ا مscri‏ (. 


مع الإصدار الأسبق من الفيجوال بيسك.إذا كنت تريد تنصيب برمجيات مخصصة باستخدام برنامج التثبيت»عليك إما كتابته بنفسك أو استخدام 
أداة مشتراة.تظهر أدوات التوزيع في النهاية في الفيجوال بيسك. وخاصة "المعالج السحري للتحزيم والتوزيع Package and Deployment‏ 
0ل "السيئ السمعة.برنامج التثبيت المعلب هذا تم كتابته في الفيجوال بيسك»وتستطيع تحسينه ليلاقي احتياجات التوزيع الخاصة بك. 
ولکن لم یکن سهل .وکان باقي العالم مسبقاً يتخذ منصة' 'منصب ويندوز" من أحل التوزيع الموحد المعايير بواسطة ملفات أ5.. یستخدم 
المعالج السحري للتحزيم والتوزيع تنسيق الملف 20ء. الأقدم .حتى من أجل مبرمج ما يستمع بالبرمجة حقاءالحاجة لكتابة برامج تنصيب فعالة 
يجعل في بعض الأحيان الحياة قبيحة. 

عندما أتت الفيجوال بيسك2002أصبحت الحياة جميلة مرة أخرى. تضمنت الفيجوال أستوديو أدوات تتيح لك استهداف تقنية منصب ويندوزء فقد 
كان نسخة محللة تتيح لك تحرير التطبيقات الأبسط فقط ولكن كان على البائعين المشاركين أن يحوزوا بعض المتعة. 

في هذه الأيامء تتضمن الفيجوال أستوديو العديد من طرق التوزيع تقدمة للأنواع المختلفة من التطبيقاتءالأنواع المختلفة من المستخدمين» 
والأنواع المختلفة من البيئات المأمونة التي من المحتمل أن يحتاج المبرمج استهدافها.أقرأً كل الطرق المتاحة لرؤية أياً منها تناسب احتياجات 
برنامجك.لقد اخترت طريقة توزيع مشروع المكتبة»ولن أبوح بها حتى منتصف هذا الفصل. 


من الواضح أن تطبيقات آسبي دوت نت مختلفة عن تطبيقات سطح المكتب.واحد من الاختلافات الكبيرة هو من أجل المستخدم النهائيء 
تطبيقات آسبي دوت نت ليس لديها حقاً أي توزيع.عليك فقط الاستعراض إلى موقع الويب المناسب وتستخدم التطبيق.ولكن مايزال التوزيع 
ضروري لخادم ویب المستضیف.إذا کان قد تم تنصیب امتدادات فورنت بیج lJFrontPageدم‏ ویب الخاص بك »تستطيع تنصيیب تطبیق آسبي 
دوت نت المترحم من بيئة التطوير الخاصة بك بكل راحة وأمان.لقد علقت عليه في الفصل23,ولكن الفيجوال أستوديو تجلب لك خيار وضع 
تطبیق ویب على موقع ویب موجود حقاً عندما تحاول للمرة الأولى إنشاء تطبیق آسبي دوت نت. في نموذج موقع ویب جدید:تستطیع اختیار 
URL‏ 3۶ کموقع تطویرء كما هو مبين في الشكل التالي. 
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Templates: .NET Framework 3,5 اګ‎ E E 


¥isual Studio installed templates 
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Service Reports WwW... Crystal Re... 


My Templates 


Search Online 
Templates... 


4 blank ASP.NET Web site {,HET Framework 3,5) 


Location: File System | | Cifebsite3 ف‎ 
File System 
Language: E 


FTP 


بما أنك ستطور موقع ويب الخاص بك ا س »من المحتمل انك لاتريد استخدام هذه الطريقة على خادم الإنتاج»بالمقابل»تستطيع 

التطوير بشكل محلي في دليل او على خادم تطوير ويب»ومن ثم فيما بعد تنشر 0/۶۸ الموقع إلى خادم الإنتاج.وهذا سهل بقدر إعداد موقع 

۶ H(برتوكول‏ نقل النص الفائق Hypertext Transport (or Transfer) Protocol‏ )من البداية.مع موقع الويب في الفيجوال أستوديوءاختر 

القائمة بناء ۵اأuا8‏ >> نشر موقع ويب أ8 ا۷6 nءاا۴ub‏ .وعين عنوان صaخة‏ llلgويب)locator(URL wılJs.uniform (or universal) resource‏ 

هناك حاجة لبرنامج تثبيت منفصل.إن آسبي دوت نت حريص فيما يخص كيفية معالجته للملفات في تطبيقك.ولن ينشر كودك المصدري. 

سیينسخ ملف و/٣٥ء.66س‏ إلى الخادم(وهو ملف مطلوب)ءوالذي يمكن أن يحتوي على نص اتصال قاعدة بياناتك.ولكن خادم ويب لأسبي دوت 
نت المركب كما ينبغي سيحفظ هذا الملف بعيدآً عن عيون المتطفلين. 


الفصل الخامس والعشرون:النشر أو التوزيع. Mhm76‏ 


نحتوي مجمعات الدوت نت المترحمة کشف یصف المجمع وحاجياته .وهذا يعني أن باستطاعتك نسخ المجمع إلى نظام أخر قد تم تنصيیب 
إصدار إطار العمل المناسب»وطالما أن الملفات الأخرى التي يحتاجها المجمع تم نسخها أيضاً »فإن البرنامج سيعمل.وهذا يدعى"التوزيع 
ixıنسwخةdeployment X×Copy‏ ".لأنك تستطیع استخدام سطر الأمر رمه ×لنقل الملفات.من المحتمل أنك تفکرحسناًء إن مجمع ۴×۴هو 
برنامج ویندوز حقيقي .بالطبع سيعمل عندما أنسخه إلى نظام جديد.حسناً وكل هذا صحيح.ولكنه لم يكن صحيح بالنسبة لتطبيقات الفيجوال 
بيسك الأقدم. فأدوات المستخدمة من قبل تطبيقات الفيجوال بيسك المعتمدة على المكونات يجب أن يتم تسجيلها في مسجل ويندوز قبل أن 
يكون بالإمكان الوصول إليها وقت التنفيذ.وتتطلب برامج الفيجوال بيسك الأقدم أيضاً أن یتم تنصیب مکتبات وقت التشغیل5٥|۲‏ 5۲2ا runtime‏ . 
ويجب أن يتم تنصيب أيضاً إطار عمل الدوت نت من أجل برامج الدوت نت .ولكن ويما أن إطار العمل يتم إدارته بشكل آلي بواسطة نظام تحديث 
ويندوز»فهذه ليست بالمشكلة العظيمة.في معظم الحالات ما أود قوله في هذه الجمل ٤ن‏ بإمكانك تنصيب تطبيق الدوت نت على جهاز ما 
بنسخ البرنامج فقطء ومن الممكن عدة ملفات دعم إلى دليل ما.ولا أقول أنها الطريقة التي عليك استخدامها لتنصيب البرامج.عملياً. سأصدم إذا 
ما اكتشفت أي صديق مبرمج يستخدم هذه الطريقة في بيئة العمل الفعلية.ولكن الدوت نت جعلت خيار التوزيع هذا متاح لك إذا كنت لاتريد أن 
تکون صديقي بعد الآن.فإذا كنت تريد استخدام النشر ×نسخة»ءمن المحتمل أنه لیس لديك أي مشكلة مع الأمنءأو التحديدات الإدارية والتي 
من الممكن أن تفرض على الجهاز. فالفرص هيءإذا ما نصبت برمجيات باستخدام الأمر ×نسخة» أو بسحب وإسقاط الملفات»من المحتمل ولأنك 
صديق مع مالك الجهاز. 


إن منصب ويندوز هو نظام تنصیب مكتبي موفر من قبل میکروسوفت .وهو یخدم کنظام قاعدي لحزم التنصيب الناتجة عن الفيجوال أستوديو 
القياسي»ويوفر 3 الدعم أساسي sوunderpinninلمعظم‏ أدوات التنصيب الأجنبية .قبل منصب ويندوزء كل بائع حزمة تنصيب يعمل شيء» إلى 
حډ ما يراه مناسب.ولکن هذا عنی أن منتجات التنصيب في بعض الأحيان تضرب obberedاcبعضها‏ بعضاءبما أن حزمة البرمجيات S04۲8‏ 
ackageم‏ ليس من الضروري أن تبحٿث عن ملفات تم تنصيبها بواسطة أداة أخرى.وإصلاح مثل هذا الضرر كان صعباً بالنسبة للمستخدم فمن 
عادة لايريد حتى أن يعرف أي الملفات التي تم تنصيبها أو تحديثمها. 

سعت میکروسوفت لتغير ذلك مع منصب ویندوز. واحدة من الميزات الرئيسية للنظام وهي قاعدة بیانات الملفات المنصبة والمحدثة .ويدعم 
منصب ويندوز أيضاً إمكانية ا لإزالة التنصيب/الترميم والمسار الراجع(التراجع)ءه ااه (الارتداد)) لذلك فيمكن التراجع عن أي فشلءإصلاح 
(أو إعادة restoring‏ )النظام إلى حالته السابقة.وميزات أخرى تتضمن دعم تصحيح البرامج من İllخطlءpatching‏ »إعادة التشغيل 
rebootin9.إصلاح‏ أو' " معالجةاaم"‏ " التنصيب السابق ولكن البرنامج المتضرر والتنصيب حسب الحاجة(أو حسب الطلب ل٣2"‏ ل-0۸-ااtaاins‏ ( 
والذي يحتفظ ll‏ أو بكامل التطبيقات على وسيلة التنصيب حتى يحاول المستخدم استخدام تلك الميزة. 

منصب ويندوز النسخة ×.4هي الإصدار الأخير من أجل ويندوز فيستا وأنظمة ويندوز الموازية(ما يزال يإمكانك ا على الإصدار ×.3من أجل 
ویندوز ۲۶× أو ×.2من أحل بعض أنظمة ویندوز الأخرى متثل ویندوز98). 

إن جوهر نظام منصب ويندوز هو ملف " ا15 "(مع ملف الامتداد /5”.).الملف الوحيد الذي يحتوي جميع الملفات والتعليمات(التوجيهات) 
الضرورية لتنصيب» تحديث.»وإزالة تنصيب منتج برمجي.تستطيع الفيجوال أستوديو إنشاء مشاريع تثبيت بالاعتماد على معيار Iا18ءعلى‏ الرغم 
من أنك لاتستطيع استخدام بعض الميزات الأكثر تقدماآً لمنصب ويندوز من خلال الفيجوال أستوديو. »إذا ما كانت احتياجاتك بسيطة ومعظم 
برمجيات العمل المكتوبة في الفيجوال بيسك لديها احتياجات تنصيب بسيطة- فما تزال الفيجوال استوديو تفي بالغرض. 

بناء مشروع تثبیت سهل تماما بقدر سهولة إنشاء مشروع تطویر فیجوال أستوديو قياسي .ولکن أولاً »احتاج شيء ما لتثبیته. .من أجل المناقشة 
في هذا الفصل»عملت على إنشاء تطبیق سطح مكتب.بكل بساطة عملت على إنشاء مشروع ۷/۸۵0W۷5۸060// ٥21/071‏ جدید مع نموذجه 
الافتراضي ۴٥۲٣1‏ »وحفظته إلى المجلدم/ ٥۱6‏ .کل ما یعمله عندما یتم تشغیله هو عرض نموذجه الافتراضي ۴٥۲٣1‏ . 

لإنشاء ملف التنصيب من أجل مشروع الفيجوال بيسكءافتح ذلك المشروع في الفيجوال أستوديو واستخدم القائمة ملف ۵ا۴ >>إضافة A۸۵۵‏ 
>>مشروع جديداءهعزه۴۲ NW‏ .لإضافة مشروع تثبيت إلى كامل الحل بحيث يحتوي على مشروعك الأصلي.يبين الشكل التالي حوار إضافة 
مشروع جدید.اختر نوع المشروع5همرا ام‌زهام :تثبیت ونشرا Setup and 20e ماهy "e‏ »ومن تم القالب "المعالج السحر للتثبيت مuأمS‏ 
04 "لإنشاء برنامجح التثبيت من المشروع الفعال.ضع حقول الاسم والموقع تبعاً للحاجات التي تناسبك»ومن ثم انقر موافق)0 . 
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Project types: Templates: NET Framework 3.,5 
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a < Other Project Types 
Setup and Deployment My Templates 
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Create a Windows Installer project with the aid of a wizard, 


Mame: Setup 


Location: Cinewinstall wv BFOWSE,,, 


معالج التنصيب السحري»يقودك خلال خمسة خطوات: 


الخطوة الأولى للمعالج تقول فقط"مرحبا"لذلك انقر الزر التالي واذهب إلى العمل الحقيقي. 
2 


الفصل الخامس والعشرون:النشر أو التوزيع. Mhm76‏ 


تطلب الخطوة 2منك نوع مشروع التثبيت الذي سينتج.شخصياًءاعتقد أنه من الممكن معرفته من محتوى المشاريع المحملة سابقاآًءولكن إذا 
فعل المعالج السحري كل شيءءلما سيحتاج العالم مبرمجين مثلنا؟توجد أريع خيارات مبينة في الشكل التالي. 


Ûo you want to create a setuıp program to install an application? 


(@ Create a setup for a Windows application 


O Create a setup for a web application 


Ûo ¥ou want to create a redistributable package? 


i Create a merge module For Windows Installer 


i Create a downloadable ZAB File 


الخيارين الأوليين في الأعلى يعملان على إنشاء ملفات تنصيب كاملة إما لتطبيقات سطح المكتب أو للويب.(التثبيت المعتمد على ويب سيتم 
تسليمه إلى مدير موقع ويب للتنصيب على الخادم.).تتيح لك وحدات الدمج sع/uكه"”‏ مو/۷/e‏ إنشاء حصة من تنصيب ما يمكن أن يتم دمجها 
فيما بعد في ملف |151 کامل.وهذا خیار جید إذا كنت تصمم مكتبة 5۲3۲۷ااسيتم استخدامها من أجل تطبيقات متعددة»ولکنه غير مفيد بحد 
ذاتە(أو لوحده).الخيار الأخير ملف 0۸8يعمل على انشاء اريف „jaarchive‏ الملفات يمكن أن یتم تنصیبها باستخدام تقنية نشر ملف أقدم 
بعض الشيء. وهو أيضاً نظام النشر المستخدم لأجهزة الكمبيوتر الصغيرة.بما أنني استهدف تطبيق سطح المكتب» سأختار الخيار الأول"إنشاء 
تثبيت من أجل تطبيق ويندوز" وانقر التالي×6. . 


على الرغم من أنك تستطيع إنشاء برنامج تثبيت يعمل ببساطة على تنصيب ملفات شتى تقتات 960١4۷6ءءمن‏ قرصك الصلب»فأنت عادة 
تبني مشروع تثبیت بالاعتماد على ملفات أو مخرجات مترحمة لمشاريع أخرى.تطلب الخطوة الثالثة للمعالج السحري منك تضمين العناصر من 
مشاریع أخریى موجودة فقي حل الفيجوال أستوديو الفعال.لقد اخترت تضمين ملف €×Eالمترحم‏ من مشروع سطح مکتبي »كما هو مبين في 
الشكل التالي.بشكل عام لا أعمل على تضمين كودي المصدري في مشروع التثبيت»لذلك سأترك تلك العناصر غير مختارة.ولكن البند ملفات 
المحتوى ۴5!أ۴ Cnt‏ يمكن أن تكون مفيدة.إذا كان مشروعي يحتوي على ملف مساعدة عبر الشبكة(مع امتداد الملف”۸ء. )ءبإمكاني 
إضافته کملف محتوی قياسي إلى ا الرئيسي بواسطة القائمة مشروع اء٥زه٣۴‏ >>إضافة بiد‏ مgجودm Add Existing Ite‏ . 


Setuıp Wizard (3 of 5)} 


Choose project outputs to include 


You can include outputs From other projects in Your solution, 


YYhich project output groups do you want to include? 
[] Localized resources from WindowsApplication1 
I #fAL Serialization Assemblies fram WindowsApplication1 
[CT] Content Files from WwindowsApplication1 
[EA] Primary output from WindowsApplication 1 
[ Source Files from WwindowsApplication1 
| Debug Symbols from WindowsApplicationı1 
O Goacumentation Files fram WindowsApplicakion1 


Description: 
Contains the DLL or ERE built by the project, 


| < Previous [net => | 1 Finish | | Cancel | 


سیتم تصيیف (أُو تبويب )ذلك الملف کمحتوی»ویمکن نقله إلى مشروع التثبيت من خلال اختیار ملفات المحتوی؟ها۴i Content‏ .ولكن توجد 
طرق أخرى لتضمين مساعدة عبر الشبكة في التنصيبء والتي سنراها في الخطوة التالية.الآن»سنبقی على الاختیار uمااه ۲y‏ 2٣٣۴ء‏ وانقر 
التالي .Ne×‏ 


في هذه الخطوةء تستطيع إضافة أي ملفات غير خاصة بمشروع معين أخرى والتي تريدها إلى مشروع التثبيت(شاهد الشكل التالي).ملفات 
اقرأني Read ne‏ »محتوى المساعدة عبر الشبكة»اتفاقيات الترخيص5أ٣٠"۳٠٠٠وه‏ مء١هءا‏ . صورة لأطفالك.وإلى حد ما أي شيء أخر يمكن أن 
يتم تضمينه هنا.لن أعمل على إضافة آي شيء أكثر. أنقر التالي Next‏ . 


Setup Wizard (4 of 5) 


Choose files to include 
You can add files such as ReadMe files or HTML pages to the setup. 


which additional files do you want to include? 


الخطوة 5. 
تعرض الخطوة الأخيرة ملخص للاختيارات التي عملته(شاهد الشكل التالي).حسناءالمعالج السحري سهل جدآً.فيقع على عاتقنا العمل في 
ثلاث خطوات من الخطوات الخمس.انقر إنهاء لاكمال المعالح السحري. 


Setup Wizard (5 of 5) 


Create Project 


The wizard will naw create ã project based on your choices, 


Summary: 


Projert type: Creata a setup For a Windows application 


Project groups to include: 
Primary output from WindowsApplication1 


Additional Files: (none) 


Projert Dirertory: C:lnewinstalliSetup11Satup1 .wdpraj 


ES EE a aa 


حالما يكتمل المعالج السحري»ءتظهر الواجهة الرئيسية لتصميم مشروع التثبيت للفيجوال أستوديو في نافذة التطوير.يبين الشكل التالي 
الفيجوال أستوديو وهي تعرض مشروع إنتاج التثبيت الأحدث ل WindowsApp/icatio^1‏ »يظهر أيضاً مشروع أخر في لوحة مستكشف الحلول. 


File system (Setup) | Famivh [Design] | Start Page Solution Explorer , 

Ej File System on Target Machine E Type 3 1ِ Ê ا‎ 1 
ا‎ Folder Primary output from ;.. Output gy] Solution Window 
J] User's Desktop 4 8 YindowsAF 
8 User's Programs Menu ZA My Proje 


Forml wt 


4 ا‎ 
4 [O Detectec 
+a Micrc 
Î Primary c 


النافذة الرئيسية في الشكل السابق واحدة من عدة محررات ك١٠اال6‏ تتيح لك تخصيص مشروع التثبيت.تستطيع الوصول إلى كل محرر من 
خلال القائمة عرض ۷6W‏ > >المحرر۲هاكع .أو باستخدام أزرار شريط الأدوات في لوحة إitoo|baمawتكشفé Solution Explorer panelJglzJll‏ . 


إنه ذلك المحرر الذي يظهر في الشكل السابق.وهو يجلب مجلد قياسي/عرض بند لحصة نظام ملفات ۳٠#أءرءه|اا؟‏ للنظام الهدق.من خلال 
هذه الطبقة الهرمية»تضع الملفات(مخرجات ع×عمن مشروعك الرئيسيءملفات المساعدةءماا؟ مام «ملفات llتركيب"configuratio‏ « 
المختصرات كااعاهطءلآأي من هذه الملفات»إلخ)في مجلدات خاصة(مجلد التطبيق ٥|١٠۲‏ ١0اةءiاممA‏ . سطح المكتبمها )وم0 »ملفات 
البرنامج 64-بت أو 32-بت۴¡|eS or 64-bit Program‏ -32. الخطوطکاہ٥۴‏ .مجلد قائمة إبدأeلاە؟ Start Menu‏ .وأخریات).إذا کنت لا تری المجلد 
الذي تريده في نظام الملفات على لوحة الجهاز المستهدف»استخدم القائمة إجراء ١ه0ناAc‏ > >إضافة مجلد خاص Add Special Fold6َ‏ 
لتضمينه في القائمة.بالإضافة إلى المجلدات الخاصة القياسيةك۲عه|اه؟ اماءممs standard‏ »تتضمن القائمة إضافة مجلد خاص Add Special‏ 
۴ خیار مجلد مخصص ۴۵۱۵۴6۲ 10۳٤لا‏ تتيح لك إنشاء مجلد معين ٥۱486۲‏ ءاأعهمء في أي مكان على النظام الهدف. 


يعرض هذا المحرر تسلسل هرمي مبتور لخلايا المسجل.إضافة أية مفاتيح أو قيم هنا سيتم إنشاءها في مسجل المستخدم user's registry‏ 
خلال التنصيب. 


يتيح لك هذا المحرر تعريف مرفقات بین امتداد ملف ما(مثل ×٤‏ .)وبرامج معينة أو إجراءات .أي إجراء مخصص.»مثل فتح أو طباعة»يمكن أن يتم 
ربطه لأي نص أمُر تریده» ومن ضمنه الأوامر التي تستهدف المجمع الرئيسي الذي سيتم تنصيبه. 
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يتضمن مشروع التنصيب الافتراضي عدة نماذج تطلب أشياء مثل موقع التنصيب والمعلومات حيث يجب أن يحدت التنصيب. تستطيع إدراج 
صناديق حور إضافية في سياق التنصيب.ولكن احذر:لن تكون قادر على إضافة نماذج تمكين الفيجوال بيسك كاملاً.بالمقابل»ستختار عدة 
حوارات مسبقة التعريف (مثل حوار اتفاقية الترخيص»أو حور أزرار التبديل الأربع ك5١٥٤اا8‏ أله 8 )ووضع خاصيات الحوار لتركيب نص العرض لكل 
حقل حوار أو طلب. كل حقل مدخلة مستخدم/أداة تتضمن قيمة بالاسم تستخدمها في المحررات الأخرى لتحديد إجراء تنصيب معين. 

سبيل المثال»تستطيع مراقبة قيمة صندوق اختبار ×>0ط۸)٥16ء‏ يطلب من المستخدم وإذا لم يختاره المستخدم فتستطيع كبح التنصيب بالنسبة 
لحقول معينة يتم إرفاقها مع صندوق الاختبار×0ط)ء‌هnہ‏ . 


إذا كنت ترید مستوی نهائي لأداةءز تستطيع إضافة إجراء مخصص»استدعاء لبرنامج خارحي أو صيغة»يتم تشغيله عند نقطة معينة في عملية 
التنصيب (أو إزالة التنصيب 


إذا كان يجب على الجهاز الهدف أن يكون في حالة معينة قبل أن تتمكن من تنصيب المشروع بشكل ناجحءفيتيح لك هذا المحرر تعريف شروط 
التحديد .بشکل افتراضي» يضيف المنصب إطار عمل الدوت نت کشرط تنصیب» فیجب أن يتم تنصيب إطار عمل الدوت نت قبل أن یتم تنصيبٍ 
المشروع.تستطيع البحث عن ملفات معينة أو مفاتيح تسجيل والتي يجب أن توجد قبل أن يبدأ التنصيب.على سبيل المثالء من المحتمل أنك 
ترید الاک على ان مشغلات قاعدة البيانات الهدف ك۲٥۷أاd‏ مك2 bهاaه‏ امواta‏ يجب أن تكون على النظام قبل تنصيب تطبيق معتمد على 
قاعدة بيانات. 


حالما تعمل على إعداد مشروعك من خلال المحررات المتنوعة»فتعمل على إخراج ملف ×8١‏ النهائي ببناء الحل بواسطة القائمة بناء ١اأ 8U‏ 
>> بناء الحل ٣N‏ ut'oاهS‏ dاBui‏ . یظهر ملف 81× في الحوضع E‏ في خاصيات مشروع التثبيت(القائمة مشروع أ٤هزه۴۲‏ >> الخاصيات 
Properties‏ )وهذا الملف يیحتوي ‹ الاختصارات والمحتوى | ب لتنصيب التطبيق بالكامل على الجهاز الهدف. 


تتضمن الفيجوال استوديو2008 طريقة توزيع تدعى نقرة واحدةععء"۸0ء//٥‏ .فقد تم تصميمها لتوفير سهولة في توزيع التنصيب النهائي من أجل 
تطبیقات سطح المکتب(نماذج ویندوز).وما يزال يحتوي معالج سحري»ولکن للتنصيبات القاعدية»هذا كل ما هنالك. حالما يتم توزيع تطبيقك من 
خClickOnceJll‏ »يستطيع المستخدم تنصيبه مباشرة من موقع ویب او موضع تخزین أخر. يبدو هذا متثل تنصيیب ا8القیاسي»ولکن مختلف 
في عدة طرق: 

«التوزيعات ٥۸0۸ءا‏ يمكن أن يتم تنصيبها حتى ولو كان المستخدم الحالي ليس لديه امتيازات إدارية محلية.العديد من البرمجيات تنصب 
ملفات مفتاحيه تؤثر في مجلدات ويندوز ۷/20 وویندوز/نظام32:32 ^ yid 0 S15 y1‏ .أو في مجلدات أخرى هامة ولكنها مجلدات 
مقيدة(أو محصورة).إذا كنت مطورءمن المحتمل أنك لن تجرب هذه المشكلةءلأنك المدير على جهازك الخاص.ولكن في تنظيمات دائرة تقنية 
معلومات المدارة مع العديد من المستخدمين»توجد منفعة لتخفيض مستوى الامتياز للمستخدمين المستقلين.تأثير واحد سلبي لهذا وهو أنه 
يجب أن يحضر المدير لتنصيب أي برنامج.ولكن هذه ليست هي الحالة مع 6٥0۸ء‏ ا٤.‏ أي تطبيق موزع ب 8٥۸0ءا‏ يمكن أن يتم تنصيبه 
بواسطة اي مستخدم. 


.التطبيقات الموزعة ب 8٥۸0۸ء‏ ا٥‏ يمكن أن تعمل على إطلاق تحديثات البرمجيات الخاصة بها بشكل آلي.إذا كان التركيب بهذه 
الطريقة»سيتفحص البرنامج موضع التوزيع الأصلي من أجل نسخة جديدة كل مرة يتم تشغيله.فإذا كان هناك نسخة جديدة»سيتم تنصيبه 
بشكل الي بدون ان يعمل المستخدم اي شيء. 

ءتطبيقات ١٥0۸ء‏ ايتم تصميمها لسهولة التنصيب.مع تطبيق التوزيعا15.تحتاج إلى تنزيل ملف ا158ومعالجته من خلال نظام منصب 
ویندوز.علی الرغم من أن عليك أيضاً تنزيل(تحميل) توزيع#٥١‏ ۸0 ءا »فهو يحدث بشفافية أكثر أو أقل .التطبيقات المنشورة بنقرة واحدة يمكن 
أن يتم ترکيبها بحيث تبدو كامتداد صفحة ويب:نقر وصلة»والبرنامج مباشرة يعمل»توزیع نموذجها الرئيسي للمستخدم(يمكن أن يكون هناك 
بعض التأخير بما أن البرنامج تم تحميله على الانترنت).إن ذلك يبدو عظيماً.ولكن ويما أن تطبیقات تمکین ۸0۸8ءا (بشکل افترضي)تعمل 
في صندوقها الرملي(ساعتها الرملية) الخاصة»فهي محدودة في وصولها إلى بعض الموارد المحلية. وأيضاء لدعم جميع ميزات التحديث الآليء 
عليك إضافة كود لتطبيقك يقوم بعمل التحديث الحقيقي.( توفر الخاصية ”رهام ءo.0ناicaاممA.رMإمكانية‏ الوصول إلى هذه الميزات) 
لتوزيع تطبيقك بواسطة nce‏ ءicاC»استخدم‏ القائمة بناء ۵ا8 >> توزيع ۸ءأاط۴في الفيجوال أستوديو.بعد أن يسألك بعض الأسئلة 
الأساسية حول من أين سیحصل المستخدم على ملف التوزيع(من موقع ويب #اأء W6‏ »مجلد شبكة۱۵6۲ا0؟ "٠۷0۲۸‏ .أو سيدي/ديفيدي 
09ع ) تعمل الفيجوال أستوديو على إنتاج ملف التنصيب وتجعله متاح مباشرة للاستخدام.بالطبع هذه الطريقة تمنحك فقط خيارات 
التنصيب القاعدية.فهي تجعل ملف ع×ع أو اا0 الرئيسي (و توابعه)لمشروعك متاحة للتنصيب على الجهاز الهدف»ولكن هذا تقريباً كل 
شي»>. .إذا کنت ترید تحکم أكثر على عملية التوزيع والمكونات التي سیتم تضمينها »استخدم تبویب التوزيع ishاPubلخاصيات‏ مشروعك »كما هو 
مبين في الشكل التالي. 
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تتضمن هذه اللوحة الحقول التي تتيح لك وضع رقم الإصدار لكل حزمة تنصيب موزعة.إذا عدلت رقم الإصدار هذا وأعدت توزيع التطبيق.فإن كود 
التوزيع | الذي أضفته إلى التطبيق يمكن أن يلتقط الإصدار الجديد ويستهل التحديث من موقع النشر. 


لقد اخترت توزيع منصب ويندوز القياسي.لأنني أظنه سيوافق معظم احتياجات مستخدم نظام المكتبة النموذجي.فقد تم إعداد تطبيق المكتبة 
بقصد أن يكون ميزة مستقرة(ثابتة)ءلذلك من المحتمل أن شخص ما مع معرفته بالمعلومات التقنية أو الامتيازات الإدارية سيقوم بعمل التنصيب 
الحقيقي.ما يزال التطبيق يحتوي العديد من الملفات»ومن ضمنها ملفي مساعدة عبر الشبكة.لذلك فالتنصيب س.نسخة سيكون عبء إضافي. 
لذلك تنصيب ا18 القياسي هو خطة التوزيع الأفضل. 


يعمل معالج التثبيت السحري على إضافة مجمع مشروعي بشكل آلي إلى ملف ا18 ولكنني متأكد أن ملفات أخرى ضرورية لتوزيع مشروع 
المكتبة بشكل مناسب.فنظرة سريعة إلى الفصول السابقة يوحي بمتطلبات القائمة التالية من الملفات التالية: 


يجب أن يتم تنصيبه على الجهاز الهدف لتشغيل تطبيق المكتبة.سيحتاج برنامج الإعداد أن يتم تنصيبه بشكل آلي إذا لم يكن مسبقاً على 


الجهاز الهدف. 


إنه المجمع الأساسي.سيكون التنصيب عديم الفائدة بدونه. 


هى ملفات المساعدة عبر الشبكة»وشيتم تتصيبها في تفس مجلد التطييق الأساسي: 
أذا خصلت على حقوق توزيع خط القيم الشاملة؛ بشتنتطيع برنامح الثثبيت تنسخه مشتكل هبار إلى جلد خطوط نظام الخهاز الهدف: 
ملف الترخيص- تذكر آنه ملف تم إنتاجه بشكل يدوي ويحتاج أن يتم صنعه بالنسبة لكل زيون يشتري تطبيق المكتبة.ترحمته مباشرة إلى 


برنامج التثبيت يبدو زيادة مفرطةءبما انني ساعمل على إنتاج تثبيت لكل زبون.بالمقابل»ساضع الملف على وسيطة(او سيدي)»وعلى 
المستخدم إيجاده عند تن برنامج المكتبة. 


توى المدير لن يتم تنصيبه بشكل افتراضي عل الجهاز.سيبقى بالمقابل على قرص التوزيع. 
إذا کنت اعمل علی تطویر تطبيق للمستخدم النهائي»سأعمل على بناء نظام تثبیت منفصل من أجل حصة الخادم مركزاً بشکل رئيسي على 


تنصيب قاعدة البيانات.بما أن هذا الكتاب تم تصميمه كمدخل فقط سأعمل فقط على نسخ صيغة بناء قاعدة البيانات إلى قرص التوزيع وافترض 
أنه مؤهل لتمثيل تقنية المعلومات أو سيأخذ مدير قاعدة البيانات المسؤولية لتنصيب هذه الخطوة. 


هذا الملف الذي على 


كما مع صيغة إنشاء قاعدة البيانات»فسأعمل على نسخ ملفات موقع الويب إلى قرص التوزيع وادع المدير يستكشف الأشياء. 


سيتضمن السيدي ملف مقلومات تماما عند الجذر الذي سيخبر المستخدم كيفية استخدام الملفات على السيدي.لم أكتب هذا الملف ختى 
الآن»ولكن سأكتبه قبل أن ينتهي هذا الفصل. 


سيتضمن ملف التثبيت الناتج فقط البنود الأربع الأولى في القائمة في الأعلى(الثالث يتضمن الخط)» والاثنين الأوليين يتم إضافتهم بشكل آلي 
معالج التثبيت السحري.إن كل ما صا جد 


مسبقاً في هذا الفصل »عملت على إضافة مشروع جديد إلى مشروع موجود»وضممتهم إلى حل واحد.من الممكن بناء مشروع تثبیت بحيیتث 

يبدو قائم ينفسه ضمن الفيجوال أُستوديو.في مثل هذه المشاريعء تحتاج إلى استعراض لإيجاد المجمع الهدف(ع×ع.ر/11/6/2عء4ع/٠/)لتضمينه‏ 

في مخرجات التثبيت.مهما يكن.لايعمل معالج التثبيت السحري الكثير لك إذا كنت ستسلك ذلك الطريق.لذلك.من أجل مشروع المكتبة»دعنا 

نضيف مشروع تثبيت جديد إلى مشروع المكتبة المحمل ضمن الفيجوال أستوديو. 

الخطوة الأولى للخطوات المتعددة المتوازية مع الخطوات التي عملناها سابقاً في هذا الفصل.فحالما تحمل مشروع المكتبة وتحفظه إلى 

مجلده الهدف.اضف مشروع تثبيت باستخدام القائمة ملف أ۴ >> إضافة ۸۵٩۵‏ >> مشروع جديداءعزها۴ سمN‏ .اختر معالج التثبيت السحري 
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Setup Wi‏ كقالب»ادخل في حقل الاسممناه4۲۷5٣طآا‏ »واستخدم مجلد مشروع المكتبة لحفظ الموقع.طبق الإعدادات التالية ضمن 
المعالج: 
.في الخطوة الثانية»اختر"إنشاء تثبيت لتطبيق وiıدja Create a setup for a Windows application‏ " 
.في الخطوة3,»اختر"مخرجات رئيسية من المكتبة۲۷ 10۲2ا Primary output r٥۳‏ "من القائمة. 
.في الخطوة 4»اعمل على إيجاد الملف”۸ء.ء/a/۷8s/ط/1‏ والملف”۸ء."/L/0/a//40‏ .في دليل تنصيب الكتاب»تستطيع إيجادها في الدليل 
الفرعي المسمی ۸/0 On| ne‏ . 
أكمل المعالج السحري واستخدم القائمة ملف ١ذ۴‏ > >حفظ الجميعاا۸ 54۷6 .عندما تسأل عن حفظ ملف الحل(١/1//2/۷.5).خزنه‏ فقط في 
دليل مشروع المكتبة»والذي سيكون مختار مسبقا. 
كما سبق»يفتح مشروع التثبيت إلى محرر نظام الملف۲هااd٤‏ "٣ءاءرS‏ هاذ۴ هطt‏ .قبل عمل أي تفيرات ضمن المحرر»دعنا نضع بعض خاصيات 
التثبيت الواسعة.انقر على تثبيت المكتبة مuاء۷8Sا۲aطİافي‏ لوحة مستكشف الحلول .وعدل الخاصيات التالية في لوحة الخاصيات5 ءا Proper‏ : 
.ضع خاصية المؤلف ٥۲‏ ا4إلى"اسمك الخاص" أو ما تشاء. 
.ضع خاصية lلڏصilنg ACME " JJ|Manufacturer‏ ". 
ءضع خاصية عنوان صفحة الصانچ ManufacturerURLإلى‏ " http://www .MHM.com‏ "أو أي موقع ویب ترغب باستخدامه. 
.ضع الخاصية "اسم lاJلiaتج ACME Library " ylJ|" ProductName‏ ". 
.ضع خاصية العنوان ١اآإلى"تنصيب‏ المكتبة". 
بما أن محرر نظام الملفات ۲٥أل٤‏ 6۳اكرS‏ أ۴ مفتوح»دعنا نعمل العديد من التفيرات هناك.عندما أضفنا المجمع L/6/2//.٠×6‏ خلال المعالج 
السحري»فإنه استكشف كل التوابع المطلوبة.ولم يعمل فقط على إضافة البرنامج الرئيسي وبنود ملف المساعدة التي تظهر في مقطع مجلد 
التطبيقءولكن تظهر ثلاث ماغات 0115إضافية جميعوا يتم استخدامها لنش خيل نقارير المكبة كما هو مبين في الشكل النالي. 
ای Library - Microsoft Visual Studio‏ 9 
Fils Edit Yiew Project Build Debug Tools Test ûrtion Window Help‏ 
ظ ك چ ھل 
File System {LibrarySetup]) | e 1‏ 
Machine Name‏ ا E File E on‏ 
LibraryA dmin, chm‏ 3 
Î LibraryBasic.chm‏ | 
«lal Microsoft. ReportYiem,,, Assembly‏ | 
«la Microsoft. ReportYiem,,, Assembly‏ 
N Microsoft, ReportYiem,,, Assembly‏ | 
Primary output fromm L,,. Output‏ 
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Items} Saved 
بما أن هذه ال كاا0الثلاث تم تزويدها من قبل ميكروسوفت كجزء من الدوت نت»فهي لا تعني الكثير لكي أعمل على تخزينها في دليل‎ 
امطدا6.مجلد النظام الخاص الذي‎ Asءembاy‎ ace )6۸٤( تنصيب تطبيقي الخاص.فهي ستذهب إلى المخزن الانتقالي للمجمع العام‎ 
يحتفظ بمجمعات الدوت نت المتشاركة.و ٥6۸ليس واحد من اختيارات المجلد المعروض في المحررءولكن يمكن أن يكون كذلك.تأكد من أن‎ 
jag (File System on Target Machine ijlgiعell محرر نظام الملفات ۲٥ااd٤ ۳ءاءرS ها۴ على اللوحة اليسارية هو قيد الاختيار(الذنذي يحوي‎ 
Global Assembly Cache ۾|عE‎ geجaل <<مجلد مخزن انتقالي‎ Add Sمم>iaا‎ ۴٥|4۴صاخ >إضافة مجلد‎ > A0١ تم استخدم القائمة إجراء‎ 
۴.يظهر المجلد الجديد.مجلد المخزن الانتقالي للمجمع العام eلاه۴ مCach yاbصmءAss اaطoاG .في اللوحة التي على الجهة‎ d٣ 
مرة أخرى»ومن ثم اسحب بنود ال اا0 الثلات إلى بند مجلد المخزن الانتقالي للمجمع‎ Aمماءةا0٥١‎ ۴١١١6١ اليسارية.اختر بند مجلد التطبيق‎ 
»كما هو مبین في الشکل التالي.‎ Gاoطaا‎ Assembاy‎ Cacheماعلا‎ 
Name Type 

Î Libraryêdmin.chrm File 

ğ] LibraryBasic.chm File 
ا‎ I crosoft.Reportwiewer Common, dll Assembly 


File System on Target Machine‏ اھ 
“êg Application Folder‏ ت 
EN Slobal Assembly Cache Folder‏ ۰ 
“lS User's Desktop‏ 
hn. 2 User's Programs Menu‏ 


YAicrasoft.Reportviewer, Processing Db jecthodel. dll eT lll 
crosaoft.Reportwiewer WinForms, dll Assembly 


ary output frarn Library fûctiwe} Dutput 


دعنا نضيف اختصارين إلى نظام المستخدم خلال التنصيب: واحد إلى سطح المكتب والأخر إلى مقطع البرامج في قائمة إبدأ.وكلا الاختصارين 
يشيران إلى المجمع ٥×٥‏ .0/2/۷// الرئيسي.يستبق المعالج السحري للتثبيت حاجاتنا بإاضافة المجلد مها)ئم2 ء۲عءل والمجلد ئ/عsئU‏ 
P09 rans Menu‏ إلى محرر نظام الملف۲٥)ااd٤‏ ۳ءاءرS‏ ٥ا۴‏ .كل ما علينا عمله إضافة اختصار إلى كل منهما. 

لنبدأ بسطح المكتب.اختر المجلدمه!۸ئه2 ء/عءل ومن ثم انقر يمين في اللوحة اليمينية(حيث ستظهر الملفات).من قائمة السياق 
(المنسدلة) اختر إنشاء اختصار جديدااعااهاإS Create New‏ .(ونفس الأمر متاح من القائمة "إجراء ١0ا٥۸‏ " عندما تكون اللوحة اليمينية قيد 
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التفعيل).يظهر حوار اختيار بند |۴٠‏ ما56 في المشروع»كما هو مبين في الشكل التالي»استعرض ضمن بند مجلد التطبيق واختر ۵۲۷" ۴٣|‏ 
from Library (Active)‏ Output.يıزظgٍر‏ ا في اللوحة اليمينية»منتظرآً منك منحه اسم ذو معنى إمنحه الاسم"برنامج المكتبة". 
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Select Item in Project 
Loak in: 1. File S4stem on Target Machine 
E Application Folder 


EŞ User's Desktop 
EŞ LIser's Programs Menu 


Source path: 


Files of type: All Files *,*) 


creel 


Select em in Project 


Look in: lêş Application Folder r a 


ZÎ Libraryadmin, chm | Add File... 
2 LibraryBasic, chm 
rimary output From Library (Aactive} | Add Dutpuk... | 


| Add Assembly... | 


Source path: 


Files of type: All Files *,*) ¥ 


| Zancel 


لإنشاء نفس الاختصار إلى قائمة إبدأءاتبع نفس الخطوات في الفقرة السابقة»ولكن من مجلد ۶٣١9۲275 ۷٥u‏ ٥ء‏ بدل المجلد ۶٣#ءل‏ 
.Desktop‏ 

إضافة هذين الاختصارين فكرة جيدة»ولكن عندما أعمل علي تنصيب برنامج جديد»أعمل مباشرة على حذق أي اختصار تم إضافته إلى سطح 
المكتب.إضافة أيقونة إلى مجلد برامج قائمة إبدأً له معنى أفضل. 

ما نحتاجه طريقة لتبديل سلوك برنامج التنصيب بحيث لايعمل على إنشاء أيقونة سطح المكتب إذا كان المستخدم لايريد ذلك.يوفر مشروع 
التنصيب طريقة لفعل هذا .أولاء »نحتاج إلى إضافة طلب حيث يشير المستخدم إلى أولوية(خيارهء٤١6۲6٠٠م‏ ) أيقونة سطح المكتب»ومن ثم نحتاج 
إلى التصرف على ذلك الخيار(أو الأولوية).تتضمن الخطوة الأولى تبديل واجهة المستخدم |٣8۲۵‏ 50۲ں لبرنامج التثبيت.يحدث مثل هذه 
التغيرات خلال محرر واجهة المستخدم,۲هااd٤‏ مcمfامtما Js‏ . اعرض هذا المحرر من خلال القائمة عرض ۴Wء۷i‏ >>المحرر ٤۴۵٥۲‏ >>واجهة 
المستخدمءعءه؟امام| ءل .يظهر محرر واجهة المستخدم,ء كما هو مبين في الشكل التالي. 

إن محرر واجهة المستخدم مقسم إلى نوعي تنصيب رئيسيين: تنصيب ااهأءاوتنصيب إداري|اهاء١|‏ مأاةءءأ١أ"‏ ه۸ .التفرع الإداري يتم 
استخدامه فقط عندما يريد المدير تخزين صورة التثبيت على مجلد شبكة متشارك.فلا يسمح لأنواع التفيرات التي نريد عملها.لذلك»دعنا نركز 
على التفرع تنصيب ااةاءماالقياسي» والذي يدير تنصيبات المستخدم القياسية على جهاز العميل.كلا التفرعين 
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Library - Microsoft Visual ...‏ 0@ 
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| @ Error List [E] output) 
Ready 

يتضمنان طلبات خطوة -خطوة التي تظهر للمستخدم خلال عمليات | لتثبيت. تخصيص طلبات تجمع البيانات يمكن أن يتم إضافته فقط إلى 
مدخلة البدء أ512۲في التفرع الرئيسي للتنصيب|ااةأئم!| . 
خلال التنصيب الحقيقيء» تطلب واجهة المستخدم من المستخدم في نمط شبيه بالمعالج السحري. خلال مرحلة استهلال البدءااة)S‏ »يجمع 
البرنامج رغبات المستخدم لباقي المعالجة. حالما ينتهي هذا المقطع»يتواصل التنصيب حتى يكتمل أو يفشل .ما علينا عمله هو إدخال خطوة 
جديدة في عملية المعالج السحري»تعرض صندوق اختبار ×0 check‏ للمستخدم تطلب منه فیما إذا ستظهر أيقونة سطح المكتب أم لا.حقول 
تجمع بيانات إضافي مثل تلك يمكن أن يتم إضافتها من خلال"الحواراتءوه‌اهاك "جديدة وهي تحدث لأن تكون حوارات تتضمن صندوق اختبار 
قابل للتخصيص.في تفرع التنصيب|ااهأء١|‏ انقر يمين على البند بدء ١١54واختر‏ إضافة حوار وهاهiا0 ۸١١‏ من قائمة السياق.تعرض نافذة إضافة 
حواروه‌اه0i‏ ۸۵۵ .المبينة في الشكل التاليء الحوارات المتاحةء أختر بند صناديق حوار(۸(:)۸) 0×sط)ء۸‏ من القائمة وانقر موافق0۸ .یظھر 
البند الجديد في التنصيب/مقطع البدءا53/اا2)١١|‏ .استخدم واسحبه للأعلى حتی یظهر بین حوار مرحباً ۷۷6۱0۳۴وحوار مجلد 
lلتنصيبFolder Installation‏ .تتيح لك حوارات صناديق الحوار (۸) كئ0×6ط)ء16٤‏ عرض حتى أريع اختيارات لصناديق اختبار مع عناوين 
مخصصة.تأكد من أنه تم اختياره في الخطوط الرئيسية e‏ تم استخدم لوحة الخاصيات ك#ناهمه۲م لوضع خاصيات هذا الحوار الجديد: 
.ضع الخاصية ×١٠۲۲٠١"84إلى‏ "خيارات التنصيب5١0اام0‏ ١0ااوااهاءه|‏ ".وهذا النص يظهر قرب أعلى نافذة الحوارءعارضة عنوان رئيسي كبير. 
.ضع خاصية ×١٠رهه8إلى‏ "اختر الخيارات التي ترغب في استخدامها لهذا |lلتنصيب Select the options you wish to use for thiS‏ 
installation‏ " 
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Register lser splash 


Prowides CheckBoxes that can be customized to control the installation. 


ETS 


.ضع خاصية ا#طةا1×هط)ءهم إلى"إضافة أيقونة برنامج المكتبة إلى سطح l|لمكتبdesktop Add an icon for ACME Library to the‏ ".وaي‏ 
تحدد النص الخاص لأداة صندوق الاختبار الأول. 

.ضع الخاصية |BRARY_DESKTOP_LINK "yJ|Checkbox<1 Property‏ ".وهذا یمنح صندوق الاختبار اسم نستطیع استخدامه فیما بعد لتبدیل 
عملية التنصيب. 

.ضع الخاصية عuا0×1۷aط)ءهاإلى"مختارك١م)عماC‏ ".وهي تجعل التنصيب بشكل افتراضي يعمل على إنشاء أيقونة سطح المكتب. 

.ضع الخاصيةءاطox×27¡sطcheck‏ .والخاصية eاطcheckbox3Visi.والخاصية‏ eاطcheckbox4Visi‏ إلى "خطأseا۴a‏ ".مما يخفي صناديق الاختبار 
الثلاتث الفير مستخدمة. 

خلال عملية التثبيت»يرى المستخدم طلب حوار جديد في الشكل التالي.وهو يتضمن نص الرأس ×8 88ط »ونص الجسداأ×ها yوdإoط‏ » 
وصندوق حوار مفرد كما تم تركيبه في خاصيات الحوار الخاص. 
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والآن حان الوقت لاستخدام إعداد صندوق الحوار السابق.أغلق محرر واجهة المستخدم 0۲ا٤‏ eعهfاماما‏ اهل وارجچ إلى محرر نظام الملف 
System Editor‏ eا۴i.اختر‏ مجلدمهاs۸م2‏ s/عءئل‏ في اللوحة اليسارية»ومن ثم اذهب إلى لوحة الخاصياتءءااممهام .واحدة من الخاصيات 
المجدولة هي "الشرط”هاا١”ه٥‏ ".والتي تتيح لك تعريف شرط منطقي 00164١‏ 8حيث عندما يكون صوابعنء) »يعمل على تنصيب الملفات 
المرافقة على سطح مكتب المستخدم. مهما يكن»إذا كان الشرط "خطاعءاه؟ ".فلا يتم وضع الملفات المرافقة على سطح مكتب المستخدم 
خلال التنصيب.ضع هذه الخاصية إلى النص التالي 
هذا هو الاسم الذي أعطيناه إلى صندوق الاختبار بالعودة إلى صندوق الحوار المصمم. خلال التنصيب»يختبر برنامج التثبيت اختيار المستخدم 
ویبدل تحدیث سطح المکتب كما تم طلبه. 
شيء» أخر لن أعمل على إضافته لإصداري من برنامج التثبيت وهو خط الكود الشاملعهلهء 2۲ط . 

jE ACME Library کا کا اا‎ 


Installation Options 


Select the options pou wish to use for this installation. 


| Add an icon for é4CME Library to the desktop 


Cancel 1 | % Back 1 | Neamt x 
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